TcpListener.AcceptTcpClientAsync Méthode

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Surcharges

AcceptTcpClientAsync()	Accepte une demande de connexion en attente en tant qu'opération asynchrone.
AcceptTcpClientAsync(CancellationToken)	Accepte une demande de connexion en attente en tant qu’opération asynchrone annulable.

AcceptTcpClientAsync()

Source:

TCPListener.cs

Accepte une demande de connexion en attente en tant qu'opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::TcpClient ^> ^ AcceptTcpClientAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.TcpClient> AcceptTcpClientAsync ();

member this.AcceptTcpClientAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync () As Task(Of TcpClient)

Retours

Task<TcpClient>

Objet de tâche représentant l'opération asynchrone. La propriété Result sur l'objet de tâche retourne un TcpClient utilisé pour envoyer et recevoir des données.

Exceptions

InvalidOperationException

L'écouteur n'a pas démarré avec un appel à la méthode Start().

SocketException

Utilisez la propriété ErrorCode pour obtenir le code d'erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation sur les codes d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois la connexion TCP acceptée.

Utilisez la TcpClient.GetStream méthode pour obtenir le sous-jacent NetworkStream du retourné TcpClient dans le Task<TResult>. vous NetworkStream fournira des méthodes d’envoi et de réception avec l’hôte distant. Lorsque vous utilisez le TcpClient, veillez à appeler sa Close méthode. Si vous souhaitez plus de flexibilité qu’une TcpClient offre, envisagez d’utiliser AcceptSocket ou AcceptSocketAsync.

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 AcceptTcpClient().

Voir aussi

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Source:

TCPListener.cs

Accepte une demande de connexion en attente en tant qu’opération asynchrone annulable.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::TcpClient ^> AcceptTcpClientAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient> AcceptTcpClientAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptTcpClientAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync (cancellationToken As CancellationToken) As ValueTask(Of TcpClient)

Paramètres

cancellationToken

CancellationToken

Jeton d’annulation qui peut être utilisé pour annuler l’opération asynchrone

Retours

ValueTask<TcpClient>

Objet de tâche représentant l'opération asynchrone. La propriété Result sur l'objet de tâche retourne un TcpClient utilisé pour envoyer et recevoir des données.

Exceptions

OperationCanceledException

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 retourné Task<TResult> se termine une fois la connexion TCP acceptée.

Utilisez la TcpClient.GetStream méthode pour obtenir le sous-jacent NetworkStream du retourné TcpClient dans le Task<TResult>. vous NetworkStream fournira des méthodes d’envoi et de réception avec l’hôte distant. Lorsque vous utilisez le TcpClient, veillez à appeler sa Close méthode. Si vous souhaitez plus de flexibilité qu’une TcpClient offre, envisagez d’utiliser AcceptSocket ou AcceptSocketAsync.

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 AcceptTcpClient().