TcpClient.Connect Méthode

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Connecte le client à un hôte TCP distant en utilisant le nom d'hôte et le numéro de port spécifiés.

Surcharges

Connect(IPEndPoint)	Connecte le client à un hôte TCP distant en utilisant le point de terminaison réseau distant spécifié.
Connect(IPAddress, Int32)	Connecte le client à un hôte TCP distant en utilisant l'adresse IP et le numéro de port spécifiés.
Connect(IPAddress[], Int32)	Connecte le client à un hôte TCP distant en utilisant les adresses IP et le numéro de port spécifiés.
Connect(String, Int32)	Connecte le client au port spécifié sur l'hôte spécifié.

Connect(IPEndPoint)

Source:

TCPClient.cs

Connecte le client à un hôte TCP distant en utilisant le point de terminaison réseau distant spécifié.

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)

Paramètres

remoteEP

IPEndPoint

IPEndPoint auquel vous souhaitez vous connecter.

Exceptions

ArgumentNullException

Le paramètre remoteEp a la valeur null.

SocketException

Une erreur s’est produite pendant l’accès au socket.

ObjectDisposedException

Le TcpClient est fermé.

Exemples

L’exemple de code suivant utilise un IPEndPoint pour se connecter à un hôte distant.

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

Remarques

Appelez cette méthode pour établir une connexion d’hôte distant synchrone au spécifié IPEndPoint. Avant d’appeler Connect, vous devez créer une instance de la classe à l’aide IPEndPoint d’une adresse IP et d’un numéro de port. Utilisez-le IPEndPointremoteEP comme paramètre. La Connect méthode est bloquée jusqu’à ce qu’elle se connecte ou échoue. Après vous être connecté avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez-le NetworkStream pour envoyer et recevoir des données.

Notes

Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Notes

Si vous recevez NotSupportedException avec un message This protocol version is not supported lors de l’utilisation de l’adresse IPv6, vérifiez que vous avez activé IPv6 dans le constructeur en passant InterNetworkV6.

Voir aussi

• IPEndPoint
• GetStream()

Connect(IPAddress, Int32)

Source:

TCPClient.cs

Connecte le client à un hôte TCP distant en utilisant l'adresse IP et le numéro de port spécifiés.

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)

Paramètres

address

IPAddress

Élément IPAddress de l'hôte auquel vous voulez vous connecter.

port

Int32

Numéro de port auquel vous voulez vous connecter.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

ArgumentOutOfRangeException

Le paramètre port n'est pas compris entre MinPort et MaxPort.

SocketException

Une erreur s’est produite pendant l’accès au socket.

ObjectDisposedException

TcpClient est fermé.

Exemples

L’exemple de code suivant utilise une adresse IP et un numéro de port pour se connecter à un hôte distant.

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

Remarques

Appelez cette méthode pour établir une connexion d’hôte distant synchrone au numéro de IPAddress port et spécifié. La Connect méthode est bloquée jusqu’à ce qu’elle se connecte ou échoue. Après vous être connecté avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez-le NetworkStream pour envoyer et recevoir des données.

Notes

Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Notes

Si vous recevez NotSupportedException avec un message This protocol version is not supported lors de l’utilisation de l’adresse IPv6, vérifiez que vous avez activé IPv6 dans le constructeur en passant InterNetworkV6.

Voir aussi

• GetStream()

Connect(IPAddress[], Int32)

Source:

TCPClient.cs

Connecte le client à un hôte TCP distant en utilisant les adresses IP et le numéro de port spécifiés.

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)

Paramètres

ipAddresses

IPAddress[]

Tableau IPAddress de l'hôte auquel vous souhaitez vous connecter.

port

Int32

Numéro de port auquel vous voulez vous connecter.

Exceptions

ArgumentNullException

Le paramètre ipAddresses a la valeur null.

ArgumentOutOfRangeException

Le numéro de port n’est pas valide.

SocketException

Une erreur s’est produite pendant la tentative d’accès au socket.

ObjectDisposedException

Socket a été fermé.

SecurityException

Un appelant situé plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.

NotSupportedException

Cette méthode est valide pour les sockets qui utilisent l'indicateur InterNetwork ou l'indicateur InterNetworkV6.

Exemples

L’exemple de code suivant utilise une adresse IP et un numéro de port pour se connecter à un hôte distant.

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

Remarques

Cette méthode est généralement utilisée immédiatement après un appel à la BeginGetHostAddresses méthode, qui peut retourner plusieurs adresses IP pour un seul hôte. Appelez la Connect méthode pour établir une connexion d’hôte distant synchrone à l’hôte spécifié par le tableau d’éléments IPAddress et le numéro de port. La Connect méthode est bloquée jusqu’à ce qu’elle se connecte ou échoue. Après vous être connecté avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez-le NetworkStream pour envoyer et recevoir des données.

Notes

Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Notes

Si vous recevez NotSupportedException avec un message This protocol version is not supported lors de l’utilisation de l’adresse IPv6, vérifiez que vous avez activé IPv6 dans le constructeur en passant InterNetworkV6.

Voir aussi

• TcpListener

Connect(String, Int32)

Source:

TCPClient.cs

Connecte le client au port spécifié sur l'hôte spécifié.

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)

Paramètres

hostname

String

Nom DNS de l'hôte distant auquel vous voulez vous connecter.

port

Int32

Numéro de port de l'hôte distant auquel vous voulez vous connecter.

Exceptions

ArgumentNullException

Le paramètre hostname a la valeur null.

ArgumentOutOfRangeException

Le paramètre port n’est pas compris entre MinPort et MaxPort.

SocketException

Une erreur s’est produite pendant l’accès au socket.

ObjectDisposedException

TcpClient est fermé.

Exemples

L’exemple de code suivant utilise le nom d’hôte et le numéro de port pour se connecter à un hôte distant.

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

Remarques

Appelez cette méthode pour établir une connexion d’hôte distant synchrone au nom d’hôte et au numéro de port spécifiés. La Connect méthode est bloquée jusqu’à ce qu’elle se connecte ou échoue. Après vous être connecté avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez-le NetworkStream pour envoyer et recevoir des données.

Si IPv6 est activé et que la Connect(String, Int32) méthode est appelée pour se connecter à un hôte qui se résout en adresses IPv6 et IPv4, la connexion à l’adresse IPv6 est tentée avant l’adresse IPv4. Cela peut avoir pour effet de retarder le délai d’établissement de la connexion si l’hôte n’écoute pas l’adresse IPv6.

Notes

Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Voir aussi

• Connect(EndPoint)
• GetStream()