TcpClient.ConnectAsync Méthode

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

Retours

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

Exceptions

Remarques

Cette opération ne 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 hôte distante synchrone au nom d’hôte et au numéro de port spécifiés en tant qu’opération asynchrone. 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 ConnectAsync(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.

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(String, Int32).

Voir aussi

• Connect(EndPoint)
• GetStream()

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

Retours

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

Exceptions

Remarques

Cette opération ne 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 hôte distant synchrone au numéro de port et spécifié IPAddress en tant qu’opération asynchrone. 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.

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPAddress, Int32).

Voir aussi

• GetStream()

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

Retours

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

Exceptions

Remarques

Cette opération ne 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ée par le tableau d’éléments et le numéro de IPAddress port en tant qu’opération asynchrone. 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.

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Connect(IPAddress[], Int32).

Voir aussi

• TcpListener