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
| Nom | Description |
|---|---|
| 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
- 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 Result propriété de l’objet de tâche retourne une TcpClient méthode utilisée pour envoyer et recevoir des données.
Exceptions
L’écouteur n’a pas été démarré avec un appel à Start().
Utilisez la ErrorCode propriété pour obtenir le code d’erreur spécifique. Lorsque vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Remarques
Cette opération ne 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 retour TcpClient dans le Task<TResult>. Vous NetworkStream fournirez des méthodes d’envoi et de réception avec l’hôte distant. Lorsque vous êtes à l’aide du TcpClient, veillez à appeler sa Close méthode. Si vous souhaitez une plus grande flexibilité qu’une TcpClient offre, envisagez d’utiliser AcceptSocket ou AcceptSocketAsync.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
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 AcceptTcpClient().
Voir aussi
S’applique à
AcceptTcpClientAsync(CancellationToken)
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- 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 Result propriété de l’objet de tâche retourne une TcpClient méthode utilisée 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 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 retour TcpClient dans le Task<TResult>. Vous NetworkStream fournirez des méthodes d’envoi et de réception avec l’hôte distant. Lorsque vous êtes à l’aide du TcpClient, veillez à appeler sa Close méthode. Si vous souhaitez une plus grande flexibilité qu’une TcpClient offre, envisagez d’utiliser AcceptSocket ou AcceptSocketAsync.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
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 AcceptTcpClient().
