TcpClient.ConnectAsync Méthode
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 en utilisant le nom d'hôte et le numéro de port spécifiés sous forme d'opération asynchrone.
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. |
- 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.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);
member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask
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
.
Une erreur s’est produite pendant l’accès au socket.
TcpClient est fermé.
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 |
- 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.
public:
System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);
member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask
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.
Socket a été fermé.
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 |
- 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.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);
member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask
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
.
Une erreur s’est produite pendant l’accès au socket.
TcpClient est fermé.
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 |
- 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.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);
public System.Threading.Tasks.Task ConnectAsync (string host, int port);
member this.ConnectAsync : string * int -> System.Threading.Tasks.Task
Public Function ConnectAsync (host As String, port As Integer) As Task
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
.
Une erreur s’est produite pendant l’accès au socket.
TcpClient est fermé.
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 |
- 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.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);
member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask
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 IPEndPoint
remoteEP
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 |
- 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.
public:
System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);
public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);
member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task
Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task
Paramètres
- 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.
Socket a été fermé.
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 |
- 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.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);
public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);
member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task
Public Function ConnectAsync (address As IPAddress, port As Integer) As Task
Paramètres
- 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
.
Une erreur s’est produite pendant l’accès au socket.
TcpClient est fermé.
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 |
- 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.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);
public System.Threading.Tasks.Task ConnectAsync (System.Net.IPEndPoint remoteEP);
member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.Task
Public Function ConnectAsync (remoteEP As IPEndPoint) As Task
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 IPEndPoint
remoteEP
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 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :