TcpClient.Connect Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Connecte le client à un hôte TCP distant à l’aide du nom d’hôte et du numéro de port spécifiés.
Surcharges
| Nom | Description |
|---|---|
| Connect(IPEndPoint) |
Connecte le client à un hôte TCP distant à l’aide du point de terminaison réseau distant spécifié. |
| Connect(IPAddress, Int32) |
Connecte le client à un hôte TCP distant à l’aide de l’adresse IP et du numéro de port spécifiés. |
| Connect(IPAddress[], Int32) |
Connecte le client à un hôte TCP distant à l’aide des adresses IP et du 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)
Connecte le client à un hôte TCP distant à l’aide du 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 avez l’intention de vous connecter.
Exceptions
Le remoteEP paramètre est null.
Une erreur s’est produite lors de l’accès au socket.
La TcpClient fermeture est terminée.
Exemples
L’exemple de code suivant utilise une IPEndPoint connexion avec un hôte distant.
//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 hôte distante synchrone au fichier 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 se bloque jusqu’à ce qu’elle se connecte ou échoue. Après la connexion avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez cette option NetworkStream pour envoyer et recevoir des données.
Note
Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
Note
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
S’applique à
Connect(IPAddress, Int32)
Connecte le client à un hôte TCP distant à l’aide de l’adresse IP et du 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
- port
- Int32
Numéro de port auquel vous envisagez de vous connecter.
Exceptions
Le address paramètre est null.
Une erreur s’est produite lors de l’accès au socket.
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 = 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 hôte distante synchrone au numéro de port et spécifié IPAddress . La Connect méthode se bloque jusqu’à ce qu’elle se connecte ou échoue. Après la connexion avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez cette option NetworkStream pour envoyer et recevoir des données.
Note
Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
Note
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
S’applique à
Connect(IPAddress[], Int32)
Connecte le client à un hôte TCP distant à l’aide des adresses IP et du 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
- port
- Int32
Numéro de port auquel vous envisagez de vous connecter.
Exceptions
Le ipAddresses paramètre est null.
Le numéro de port n’est pas valide.
Une erreur s’est produite lors de la tentative d’accès au socket.
Il Socket a été fermé.
Un appelant plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.
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 = 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 hôte distante synchrone à l’hôte spécifié par le tableau d’éléments et le numéro de IPAddress port. La Connect méthode se bloque jusqu’à ce qu’elle se connecte ou échoue. Après la connexion avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez cette option NetworkStream pour envoyer et recevoir des données.
Note
Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
Note
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
S’applique à
Connect(String, Int32)
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 envisagez de vous connecter.
- port
- Int32
Numéro de port de l’hôte distant auquel vous envisagez de vous connecter.
Exceptions
Le hostname paramètre est null.
Une erreur s’est produite lors de l’accès au socket.
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 = 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 hôte distante synchrone au nom d’hôte et au numéro de port spécifiés. La Connect méthode se bloque jusqu’à ce qu’elle se connecte ou échoue. Après la connexion avec l’hôte distant, utilisez la GetStream méthode pour obtenir le sous-jacent NetworkStream. Utilisez cette option 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 aux adresses IPv6 et IPv4, la connexion à l’adresse IPv6 est tentée en premier 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 sur l’adresse IPv6.
Note
Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.