TcpClient.ConnectAsync Méthode

Définition

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

Surcharges

ConnectAsync(String, Int32, CancellationToken)

Connecte le client au port TCP spécifié sur l'hôte spécifié sous forme d'opération asynchrone.

ConnectAsync(IPAddress[], Int32, CancellationToken)

Connecte le client à un hôte TCP distant en utilisant les adresses IP et le numéro de port spécifiés sous forme d'opération asynchrone.

ConnectAsync(IPAddress, Int32, CancellationToken)

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

ConnectAsync(String, Int32)

Connecte le client au port TCP spécifié sur l'hôte spécifié sous forme d'opération asynchrone.

ConnectAsync(IPEndPoint, CancellationToken)

Connecte le client à un hôte TCP distant à l’aide du point de terminaison spécifié comme opération asynchrone.

ConnectAsync(IPAddress[], Int32)

Connecte le client à un hôte TCP distant en utilisant les adresses IP et le numéro de port spécifiés sous forme d'opération asynchrone.

ConnectAsync(IPAddress, Int32)

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

ConnectAsync(IPEndPoint)

Connecte le client à un hôte TCP distant à l’aide du point de terminaison spécifié comme opération asynchrone.

ConnectAsync(String, Int32, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Connecte le client au port TCP spécifié sur l'hôte spécifié sous forme d'opération asynchrone.

C#
public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);

Paramètres

host
String

Nom DNS de l’hôte distant.

port
Int32

Numéro de port de l'hôte distant.

cancellationToken
CancellationToken

Jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.

Retours

Tâche qui représente l'opération de connexion asynchrone.

Exceptions

Le paramètre host a la valeur null.

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

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

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. La tâche retournée se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

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 en tant qu’opération asynchrone. 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 ConnectAsync(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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Connect(String, Int32).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET 5, 6, 7, 8, 9

ConnectAsync(IPAddress[], Int32, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
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 sous forme d'opération asynchrone.

C#
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

Paramètres

addresses
IPAddress[]

Tableau d’adresses IP de l’hôte distant.

port
Int32

Numéro de port de l'hôte distant.

cancellationToken
CancellationToken

Jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.

Retours

Tâche qui représente l'opération de connexion asynchrone.

Exceptions

Le paramètre ipAddresses a la valeur null.

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

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

Un appelant situé 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.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. La tâche retournée se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

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 cette méthode pour établir une connexion d’hôte distant synchrone à l’hôte spécifié par le tableau d’adresses IP et le numéro de port en tant qu’opération asynchrone. 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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Connect(IPAddress[], Int32).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET 5, 6, 7, 8, 9

ConnectAsync(IPAddress, Int32, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
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 sous forme d'opération asynchrone.

C#
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

Paramètres

address
IPAddress

Adresse IP de l’hôte distant.

port
Int32

Numéro de port de l'hôte distant.

cancellationToken
CancellationToken

Jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.

Retours

Tâche qui représente l'opération de connexion asynchrone.

Exceptions

Le paramètre address a la valeur null.

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

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

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. La tâche retournée se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

Appelez cette méthode pour établir une connexion d’hôte distant synchrone à l’adresse IP et au numéro de port spécifiés en tant qu’opération asynchrone. 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 le .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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPAddress, Int32).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET 5, 6, 7, 8, 9

ConnectAsync(String, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Connecte le client au port TCP spécifié sur l'hôte spécifié sous forme d'opération asynchrone.

C#
public System.Threading.Tasks.Task ConnectAsync (string host, int port);

Paramètres

host
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.

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

Le paramètre host a la valeur null.

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

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

Remarques

Cette opération ne se bloque pas. L’objet Returns Task retourné se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

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 en tant qu’opération asynchrone. Après vous être connecté à 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 ConnectAsync(String, Int32) méthode est appelée pour se connecter à un hôte qui est résolu 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 sur 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 reporter à 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 le .NET Framework.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(String, Int32).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

ConnectAsync(IPEndPoint, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Connecte le client à un hôte TCP distant à l’aide du point de terminaison spécifié en tant qu’opération asynchrone.

C#
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

Paramètres

remoteEP
IPEndPoint

IPEndPoint auquel vous souhaitez vous connecter.

cancellationToken
CancellationToken

Jeton d’annulation utilisé pour propager la notification indiquant que cette opération doit être annulée.

Retours

Tâche représentant l’opération asynchrone.

Exceptions

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. L’objet Returns Task retourné se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

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 un 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 vous être connecté à 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.

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 reporter à 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 le .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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPEndPoint).

S’applique à

.NET 9 et autres versions
Produit Versions
.NET 6, 7, 8, 9

ConnectAsync(IPAddress[], Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
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 sous forme d'opération asynchrone.

C#
public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);

Paramètres

addresses
IPAddress[]

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

port
Int32

Numéro de port auquel vous voulez vous connecter.

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

Le paramètre ipAddresses a la valeur null.

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

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

Un appelant situé 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.

Remarques

Cette opération ne se bloque pas. L’objet Returns Task retourné se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

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 cette méthode pour établir une connexion d’hôte distant synchrone à l’hôte spécifié par le tableau d’éléments et le numéro de IPAddress port en tant qu’opération asynchrone. Après vous être connecté à 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.

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 reporter à 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 le .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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPAddress[], Int32).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

ConnectAsync(IPAddress, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
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 sous forme d'opération asynchrone.

C#
public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);

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.

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

Le paramètre address a la valeur null.

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

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

Remarques

Cette opération ne se bloque pas. L’objet Returns Task retourné se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

Appelez cette méthode pour établir une connexion d’hôte distant synchrone au numéro et au numéro de port spécifiés IPAddress en tant qu’opération asynchrone. Après vous être connecté à 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.

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 reporter à 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 le .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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPAddress, Int32).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

ConnectAsync(IPEndPoint)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Connecte le client à un hôte TCP distant à l’aide du point de terminaison spécifié en tant qu’opération asynchrone.

C#
public System.Threading.Tasks.Task ConnectAsync (System.Net.IPEndPoint remoteEP);

Paramètres

remoteEP
IPEndPoint

IPEndPoint auquel vous souhaitez vous connecter.

Retours

Tâche représentant l’opération asynchrone.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task se termine une fois la connexion TCP établie. Cette méthode ne bloque pas le thread appelant pendant que la demande de connexion est en cours.

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 un 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 vous être connecté à 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.

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 reporter à 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 le .NET Framework.

Notes

Si vous recevez un NotSupportedException message avec le message « Cette version de protocole n’est pas prise en charge » lors de l’utilisation de l’adresse IPv6, assurez-vous que vous avez activé IPv6 dans le constructeur en passant InterNetworkV6.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPEndPoint).

S’applique à

.NET 9 et autres versions
Produit Versions
.NET 6, 7, 8, 9