TcpClient.Connect Methode

Definition

Verbindet den Client mit einem Remote-TCP-Host mit dem angegebenen Hostnamen und der angegebenen Portnummer.

Überlädt

Name Beschreibung
Connect(IPEndPoint)

Verbindet den Client mithilfe des angegebenen Remotenetzwerkendpunkts mit einem Remote-TCP-Host.

Connect(IPAddress, Int32)

Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adresse und Portnummer.

Connect(IPAddress[], Int32)

Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adressen und Portnummer.

Connect(String, Int32)

Verbindet den Client mit dem angegebenen Port auf dem angegebenen Host.

Connect(IPEndPoint)

Verbindet den Client mithilfe des angegebenen Remotenetzwerkendpunkts mit einem Remote-TCP-Host.

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)

Parameter

remoteEP
IPEndPoint

Die IPEndPoint Verbindung, mit der Sie eine Verbindung herstellen möchten.

Ausnahmen

Der remoteEP Parameter ist null.

Fehler beim Zugriff auf den Socket.

Das TcpClient ist geschlossen.

Beispiele

Im folgenden Codebeispiel wird eine IPEndPoint Verbindung mit einem Remotehost hergestellt.

//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)

Hinweise

Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit der angegebenen Methode IPEndPointherzustellen. Vor dem Aufrufen Connectmüssen Sie eine Instanz der IPEndPoint Klasse mit einer IP-Adresse und einer Portnummer erstellen. Verwenden Sie dies IPEndPoint als remoteEP Parameter. Die Connect Methode wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.

Note

Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Note

Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.

Weitere Informationen

Gilt für:

Connect(IPAddress, Int32)

Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adresse und Portnummer.

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)

Parameter

address
IPAddress

Der IPAddress Host, mit dem Sie eine Verbindung herstellen möchten.

port
Int32

Die Portnummer, mit der Sie eine Verbindung herstellen möchten.

Ausnahmen

Der address Parameter ist null.

Dies port ist nicht zwischen MinPort und MaxPort.

Fehler beim Zugriff auf den Socket.

Beispiele

Im folgenden Codebeispiel wird eine IP-Adresse und eine Portnummer verwendet, um eine Verbindung mit einem Remotehost herzustellen.

//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)

Hinweise

Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit der angegebenen IPAddress Und Portnummer herzustellen. Die Connect Methode wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.

Note

Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Note

Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.

Weitere Informationen

Gilt für:

Connect(IPAddress[], Int32)

Verbindet den Client mit einem Remote-TCP-Host mithilfe der angegebenen IP-Adressen und Portnummer.

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)

Parameter

ipAddresses
IPAddress[]

Das IPAddress Array des Hosts, mit dem Sie eine Verbindung herstellen möchten.

port
Int32

Die Portnummer, mit der Sie eine Verbindung herstellen möchten.

Ausnahmen

Der ipAddresses Parameter ist null.

Die Portnummer ist ungültig.

Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.

Das Socket wurde geschlossen.

Ein aufrufer höher im Aufrufstapel verfügt nicht über die Berechtigung für den angeforderten Vorgang.

Diese Methode ist für Sockets gültig, die das InterNetwork Flag oder die InterNetworkV6 Kennzeichnung verwenden.

Beispiele

Im folgenden Codebeispiel wird eine IP-Adresse und eine Portnummer verwendet, um eine Verbindung mit einem Remotehost herzustellen.

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");
}

Hinweise

Diese Methode wird in der Regel unmittelbar nach einem Aufruf der BeginGetHostAddresses Methode verwendet, wodurch mehrere IP-Adressen für einen einzelnen Host zurückgegeben werden können. Rufen Sie die Connect Methode auf, um eine synchrone Remotehostverbindung mit dem Host herzustellen, der durch das Array von IPAddress Elementen und der Portnummer angegeben wird. Die Connect Methode wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.

Note

Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Note

Wenn Beim Verwenden der IPv6-Adresse notSupportedException mit Einer Nachricht This protocol version is not supported angezeigt wird, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.

Weitere Informationen

Gilt für:

Connect(String, Int32)

Verbindet den Client mit dem angegebenen Port auf dem angegebenen 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)

Parameter

hostname
String

Der DNS-Name des Remotehosts, mit dem Sie eine Verbindung herstellen möchten.

port
Int32

Die Portnummer des Remotehosts, mit dem Sie eine Verbindung herstellen möchten.

Ausnahmen

Der hostname Parameter ist null.

Der port Parameter liegt nicht zwischen MinPort und MaxPort.

Fehler beim Zugriff auf den Socket.

Beispiele

Im folgenden Codebeispiel wird der Hostname und die Portnummer verwendet, um eine Verbindung mit einem Remotehost herzustellen.

//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)

Hinweise

Rufen Sie diese Methode auf, um eine synchrone Remotehostverbindung mit dem angegebenen Hostnamen und der angegebenen Portnummer herzustellen. Die Connect Methode wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Verwenden Sie nach der Verbindung mit dem Remotehost die GetStream Methode, um die zugrunde liegende NetworkStreamAbzurufen. Verwenden Sie diese NetworkStream Informationen zum Senden und Empfangen von Daten.

Wenn IPv6 aktiviert ist und die Methode aufgerufen wird, um eine Verbindung mit einem Host herzustellen, der Connect(String, Int32) sowohl zu IPv6- als auch zu IPv4-Adressen aufgelöst wird, wird die Verbindung mit der IPv6-Adresse zuerst vor der IPv4-Adresse versucht. Dies kann dazu führen, dass die Zeit zum Herstellen der Verbindung verzögert wird, wenn der Host nicht auf die IPv6-Adresse lauscht.

Note

Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Weitere Informationen

Gilt für: