TcpClient.Connect Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Stellt mit dem angegebenen Hostnamen und der angegebenen Portnummer eine Verbindung zwischen dem Client und einem TCP-Remotehost her.

Überlädt

Connect(IPEndPoint)	Verbindet unter Verwendung des angegebenen Endpunkts des Remotenetzwerks den Client mit einem TCP-Remotehost.
Connect(IPAddress, Int32)	Verbindet unter Verwendung der angegebenen IP-Adresse und Portnummer den Client mit einem TCP-Remotehost.
Connect(IPAddress[], Int32)	Verbindet unter Verwendung der angegebenen IP-Adressen und Portnummer den Client mit einem TCP-Remotehost.
Connect(String, Int32)	Verbindet den Client mit dem angegebenen Port auf dem angegebenen Host.

Connect(IPEndPoint)

Quelle:

TCPClient.cs

Verbindet unter Verwendung des angegebenen Endpunkts des Remotenetzwerks den Client mit einem TCP-Remotehost.

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

Der IPEndPoint, mit dem eine Verbindung hergestellt werden soll.

Ausnahmen

ArgumentNullException

Der remoteEp-Parameter ist null.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

ObjectDisposedException

Der TcpClient ist geschlossen.

Beispiele

Im folgenden Codebeispiel wird ein IPEndPoint verwendet, um eine Verbindung mit einem Remotehost herzustellen.

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( ipEndPoint );

//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 dem angegebenen IPEndPointherzustellen. Bevor Sie aufrufenConnect, müssen Sie eine instance der IPEndPoint -Klasse mithilfe einer IP-Adresse und einer Portnummer erstellen. Verwenden Sie dies IPEndPoint als remoteEP Parameter. Die Connect -Methode wird blockiert, bis eine Verbindung hergestellt wird oder ein Fehler auftritt. Nachdem Sie eine Verbindung mit dem Remotehost hergestellt haben, verwenden Sie die GetStream -Methode, um die zugrunde liegende NetworkStreamabzurufen. Verwenden Sie dies NetworkStream , um Daten zu senden und zu empfangen.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Hinweis

Wenn Sie notSupportedException mit der Meldung This protocol version is not supported erhalten, während Sie die IPv6-Adresse verwenden, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.

Weitere Informationen

• IPEndPoint
• GetStream()

Connect(IPAddress, Int32)

Quelle:

TCPClient.cs

Verbindet unter Verwendung der angegebenen IP-Adresse und Portnummer den Client mit einem TCP-Remotehost.

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

Die IPAddress des Hosts, mit dem eine Verbindung hergestellt werden soll.

port

Int32

Die Portnummer, mit der eine Verbindung hergestellt werden soll.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

ArgumentOutOfRangeException

Der port-Parameter liegt nicht zwischen MinPort und MaxPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

ObjectDisposedException

Der TcpClient ist geschlossen.

Beispiele

Im folgenden Codebeispiel werden 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 = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
tcpClient->Connect( ipAddress, 11003 );

//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 Portnummer und herzustellen. Die Connect -Methode wird blockiert, bis eine Verbindung hergestellt wird oder ein Fehler auftritt. Nachdem Sie eine Verbindung mit dem Remotehost hergestellt haben, verwenden Sie die GetStream -Methode, um die zugrunde liegende NetworkStreamabzurufen. Verwenden Sie dies NetworkStream , um Daten zu senden und zu empfangen.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Hinweis

Wenn Sie notSupportedException mit der Meldung This protocol version is not supported erhalten, während Sie die IPv6-Adresse verwenden, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.

Weitere Informationen

• GetStream()

Connect(IPAddress[], Int32)

Quelle:

TCPClient.cs

Verbindet unter Verwendung der angegebenen IP-Adressen und Portnummer den Client mit einem TCP-Remotehost.

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[]

Die IPAddress des Hosts, mit dem eine Verbindung hergestellt werden soll.

port

Int32

Die Portnummer, mit der eine Verbindung hergestellt werden soll.

Ausnahmen

ArgumentNullException

Der ipAddresses-Parameter ist null.

ArgumentOutOfRangeException

Die Portnummer ist ungültig.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

SecurityException

Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.

NotSupportedException

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

Beispiele

Im folgenden Codebeispiel werden 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 = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}

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, die mehrere IP-Adressen für einen einzelnen Host zurückgeben kann. Rufen Sie die Connect -Methode auf, um eine synchrone Remotehostverbindung mit dem Host herzustellen, der durch das Array von IPAddress Elementen und die Portnummer angegeben wird. Die Connect -Methode wird blockiert, bis eine Verbindung hergestellt wird oder ein Fehler auftritt. Nachdem Sie eine Verbindung mit dem Remotehost hergestellt haben, verwenden Sie die GetStream -Methode, um die zugrunde liegende NetworkStreamabzurufen. Verwenden Sie dies NetworkStream , um Daten zu senden und zu empfangen.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Hinweis

Wenn Sie notSupportedException mit der Meldung This protocol version is not supported erhalten, während Sie die IPv6-Adresse verwenden, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.

Weitere Informationen

• TcpListener

Connect(String, Int32)

Quelle:

TCPClient.cs

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 eine Verbindung hergestellt werden soll.

port

Int32

Die Portnummer des Remotehosts, mit dem eine Verbindung hergestellt werden soll.

Ausnahmen

ArgumentNullException

Der hostname-Parameter ist null.

ArgumentOutOfRangeException

Der port-Parameter liegt nicht zwischen MinPort und MaxPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

ObjectDisposedException

Der TcpClient ist geschlossen.

Beispiele

Im folgenden Codebeispiel werden 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 = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );

//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 eine Verbindung hergestellt wird oder ein Fehler auftritt. Nachdem Sie eine Verbindung mit dem Remotehost hergestellt haben, verwenden Sie die GetStream -Methode, um die zugrunde liegende NetworkStreamabzurufen. Verwenden Sie dies NetworkStream , um Daten zu senden und zu empfangen.

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

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Weitere Informationen

• Connect(EndPoint)
• GetStream()