TcpListener.AcceptTcpClientAsync 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.
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
- Source:
- TCPListener.cs
- 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
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
L'écouteur n'a pas démarré avec un appel à la méthode Start().
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
S’applique à
AcceptTcpClientAsync(CancellationToken)
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- 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
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
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().
