TcpClient Constructors

Definitie

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.

De port parameter bevindt zich niet tussen MinPort en MaxPort.

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.

Zie ook

Van toepassing op