TcpClient.Connect Methode

Definitie

Hiermee wordt de client verbonden met een externe TCP-host met behulp van de opgegeven hostnaam en poortnummer.

Overloads

Name Description
Connect(IPEndPoint)

Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven externe netwerkeindpunt.

Connect(IPAddress, Int32)

Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven IP-adres en poortnummer.

Connect(IPAddress[], Int32)

Hiermee wordt de client verbonden met een externe TCP-host met behulp van de opgegeven IP-adressen en het poortnummer.

Connect(String, Int32)

Hiermee wordt de client verbonden met de opgegeven poort op de opgegeven host.

Connect(IPEndPoint)

Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven externe netwerkeindpunt.

public:
 void Connect(System::Net::IPEndPoint ^ remoteEP);
public void Connect(System.Net.IPEndPoint remoteEP);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (remoteEP As IPEndPoint)

Parameters

remoteEP
IPEndPoint

De IPEndPoint verbinding waarmee u verbinding wilt maken.

Uitzonderingen

De remoteEP parameter is null.

Er is een fout opgetreden bij het openen van de socket.

Voorbeelden

In het volgende codevoorbeeld wordt een IPEndPoint code gebruikt om verbinding te maken met een externe host.

//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

tcpClient.Connect (ipEndPoint);
'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

tcpClient.Connect(ipEndPoint)

Opmerkingen

Roep deze methode aan om een synchrone externe hostverbinding tot stand te brengen met de opgegeven IPEndPoint. Voordat u aanroept Connect, moet u een exemplaar van de IPEndPoint klasse maken met behulp van een IP-adres en een poortnummer. Gebruik deze IPEndPoint als parameter remoteEP . De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.

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.

Note

Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.

Zie ook

Van toepassing op

Connect(IPAddress, Int32)

Hiermee wordt de client verbonden met een externe TCP-host met behulp van het opgegeven IP-adres en poortnummer.

public:
 void Connect(System::Net::IPAddress ^ address, int port);
public void Connect(System.Net.IPAddress address, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (address As IPAddress, port As Integer)

Parameters

address
IPAddress

De IPAddress host waarmee u verbinding wilt maken.

port
Int32

Het poortnummer waarmee u verbinding wilt maken.

Uitzonderingen

De address parameter is null.

Het port is niet tussen MinPort en MaxPort.

Er is een fout opgetreden bij het openen van de socket.

Voorbeelden

In het volgende codevoorbeeld wordt een IP-adres en poortnummer gebruikt om verbinding te maken met een externe host.

//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];

tcpClient.Connect (ipAddress, 11003);
'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)

Opmerkingen

Roep deze methode aan om een synchrone externe hostverbinding tot stand te brengen met het opgegeven IPAddress en poortnummer. De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.

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.

Note

Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.

Zie ook

Van toepassing op

Connect(IPAddress[], Int32)

Hiermee wordt de client verbonden met een externe TCP-host met behulp van de opgegeven IP-adressen en het poortnummer.

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);
public void Connect(System.Net.IPAddress[] ipAddresses, int port);
member this.Connect : System.Net.IPAddress[] * int -> unit
Public Sub Connect (ipAddresses As IPAddress(), port As Integer)

Parameters

ipAddresses
IPAddress[]

De IPAddress matrix van de host waarmee u verbinding wilt maken.

port
Int32

Het poortnummer waarmee u verbinding wilt maken.

Uitzonderingen

De ipAddresses parameter is null.

Het poortnummer is ongeldig.

Er is een fout opgetreden bij het openen van de socket.

Een aanroeper hoger in de aanroepstack heeft geen machtiging voor de aangevraagde bewerking.

Deze methode is geldig voor sockets die gebruikmaken van de InterNetwork vlag of de InterNetworkV6 vlag.

Voorbeelden

In het volgende codevoorbeeld wordt een IP-adres en poortnummer gebruikt om verbinding te maken met een externe host.

static void DoConnect(string host, int port)
{
    // Connect to the specified host.
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    IPAddress[] IPAddresses = Dns.GetHostAddresses(host);

    Console.WriteLine("Establishing connection to {0}", host);
    t.Connect(IPAddresses, port);

    Console.WriteLine("Connection established");
}

Opmerkingen

Deze methode wordt doorgaans onmiddellijk na een aanroep naar de BeginGetHostAddresses methode gebruikt, waardoor meerdere IP-adressen voor één host kunnen worden geretourneerd. Roep de Connect methode aan om een synchrone externe hostverbinding tot stand te brengen met de host die is opgegeven door de matrix met IPAddress elementen en het poortnummer. De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.

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.

Note

Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.

Zie ook

Van toepassing op

Connect(String, Int32)

Hiermee wordt de client verbonden met de opgegeven poort op de opgegeven host.

public:
 void Connect(System::String ^ hostname, int port);
public void Connect(string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (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 worden de hostnaam en het poortnummer gebruikt om verbinding te maken met een externe host.

//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);
'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()

   tcpClient.Connect("www.contoso.com", 11002)

Opmerkingen

Roep deze methode aan om een synchrone externe hostverbinding tot stand te brengen met de opgegeven hostnaam en poortnummer. De Connect methode wordt geblokkeerd totdat deze verbinding maakt of mislukt. Nadat u verbinding hebt gemaakt met de externe host, gebruikt u de GetStream methode om de onderliggende NetworkStreamgegevens op te halen. Gebruik deze NetworkStream optie om gegevens te verzenden en te ontvangen.

Als IPv6 is ingeschakeld en de Connect(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