TcpClient.Connect Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- port
- Int32
Die Portnummer, mit der Sie eine Verbindung herstellen möchten.
Ausnahmen
Der address Parameter ist null.
Fehler beim Zugriff auf den Socket.
TcpClient ist geschlossen.
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.
Fehler beim Zugriff auf den Socket.
TcpClient ist geschlossen.
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.