TcpClient Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de TcpClient klasse.
Overloads
| Name | Description |
|---|---|
| TcpClient() |
Initialiseert een nieuw exemplaar van de TcpClient klasse. |
| TcpClient(IPEndPoint) |
Initialiseert een nieuw exemplaar van de TcpClient klasse en verbindt deze met het opgegeven lokale eindpunt. |
| TcpClient(AddressFamily) |
Initialiseert een nieuw exemplaar van de TcpClient klasse met de opgegeven familie. |
| TcpClient(String, Int32) |
Initialiseert een nieuw exemplaar van de TcpClient klasse en maakt verbinding met de opgegeven poort op de opgegeven host. |
TcpClient()
Initialiseert een nieuw exemplaar van de TcpClient klasse.
public:
TcpClient();
public TcpClient();
Public Sub New ()
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de parameterloze constructor gebruikt om een nieuwe TcpClientte maken.
//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();
'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient
Opmerkingen
Met deze constructor wordt een nieuwe TcpClient gemaakt en kan de onderliggende serviceprovider het meest geschikte lokale IP-adres en poortnummer toewijzen. U moet eerst de Connect methode aanroepen voordat u gegevens verzendt en ontvangt.
Note
In .NET Framework werkt deze constructor alleen met IPv4-adrestypen.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Zie ook
Van toepassing op
TcpClient(IPEndPoint)
Initialiseert een nieuw exemplaar van de TcpClient klasse en verbindt deze met het opgegeven lokale eindpunt.
public:
TcpClient(System::Net::IPEndPoint ^ localEP);
public TcpClient(System.Net.IPEndPoint localEP);
new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient
Public Sub New (localEP As IPEndPoint)
Parameters
- localEP
- IPEndPoint
De IPEndPoint verbinding waarmee u het TCP Socketverbindt.
Uitzonderingen
De localEP parameter is null.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een exemplaar van de TcpClient klasse maakt met behulp van een lokaal eindpunt.
//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);
'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)
Dim tcpClientA As New TcpClient(ipLocalEndPoint)
Opmerkingen
Deze constructor maakt een nieuwe TcpClient en verbindt deze met de IPEndPoint opgegeven door de localEP parameter. Voordat u deze constructor aanroept, moet u een IPEndPoint ip-adres en poortnummer maken van waaruit u gegevens wilt verzenden en ontvangen. U hoeft geen lokaal IP-adres en poortnummer op te geven voordat u verbinding maakt en communiceert. Als u een TcpClient andere constructor maakt, wijst de onderliggende serviceprovider het meest geschikte lokale IP-adres en poortnummer toe.
U moet de Connect methode aanroepen voordat u gegevens verzendt en ontvangt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Zie ook
Van toepassing op
TcpClient(AddressFamily)
Initialiseert een nieuw exemplaar van de TcpClient klasse met de opgegeven familie.
public:
TcpClient(System::Net::Sockets::AddressFamily family);
public TcpClient(System.Net.Sockets.AddressFamily family);
new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient
Public Sub New (family As AddressFamily)
Parameters
- family
- AddressFamily
Het AddressFamily IP-protocol.
Uitzonderingen
De family parameter is niet gelijk aan AddressFamily.InterNetwork
– of –
De family parameter is niet gelijk aan AddressFamily.InterNetworkV6
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een exemplaar van de TcpClient klasse maakt.
TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)
Opmerkingen
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Van toepassing op
TcpClient(String, Int32)
Initialiseert een nieuw exemplaar van de TcpClient klasse en maakt verbinding met de opgegeven poort op de opgegeven host.
public:
TcpClient(System::String ^ hostname, int port);
public TcpClient(string hostname, int port);
new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient
Public Sub New (hostname As String, port As Integer)
Parameters
- hostname
- String
De DNS-naam van de externe host waarmee u verbinding wilt maken.
- port
- Int32
Het poortnummer van de externe host waarmee u verbinding wilt maken.
Uitzonderingen
De hostname parameter is null.
Er is een fout opgetreden bij het openen van de socket.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een exemplaar van de TcpClient klasse maakt met behulp van een hostnaam en poortnummer.
//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);
'Creates a TCPClient using hostname and port.
Dim tcpClientB As New TcpClient("www.contoso.com", 11000)
Opmerkingen
Deze constructor maakt een nieuwe TcpClient en maakt een synchrone verbinding met de opgegeven hostnaam en poortnummer. De onderliggende serviceprovider wijst het meest geschikte lokale IP-adres en poortnummer toe.
TcpClient wordt geblokkeerd totdat deze verbinding maakt of mislukt. Met deze constructor kunt u de DNS-hostnaam initialiseren, omzetten en in één handige stap verbinding maken.
Als IPv6 is ingeschakeld en de TcpClient(String, Int32) methode wordt aangeroepen om verbinding te maken met een host die wordt omgezet naar zowel IPv6- als IPv4-adressen, wordt de verbinding met het IPv6-adres eerst geprobeerd vóór het IPv4-adres. Dit kan het gevolg zijn van het vertragen van de tijd om de verbinding tot stand te brengen als de host niet luistert op het IPv6-adres.
Note
Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.