TcpListener.AcceptSocketAsync Méthode

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Surcharges

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

AcceptSocketAsync()

Source:

TCPListener.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptSocketAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptSocketAsync ();

member this.AcceptSocketAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync () As Task(Of Socket)

Retours

Task<Socket>

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

Exceptions

InvalidOperationException

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

Remarques

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

Le Socket retourné dans Task<TResult> est initialisé avec l’adresse IP et le numéro de port de l’hôte distant. Vous pouvez utiliser l’une Send des méthodes et Receive disponibles dans la Socket classe pour communiquer avec l’hôte distant. Lorsque vous avez terminé d’utiliser , Socketveillez à appeler sa Close méthode. Si votre application est relativement simple, envisagez d’utiliser la AcceptTcpClient méthode plutôt que la AcceptSocketAsync méthode . TcpClient vous fournit des méthodes simples pour envoyer et recevoir des données sur un réseau en mode synchrone bloquant.

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

Voir aussi

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(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::Socket ^> AcceptSocketAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptSocketAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptSocketAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

Paramètres

cancellationToken

CancellationToken

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

Retours

ValueTask<Socket>

Objet de tâche représentant l'opération asynchrone. La propriété Result sur l'objet de tâche retourne un Socket 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 de socket acceptée.

Le Socket retourné dans Task<TResult> est initialisé avec l’adresse IP et le numéro de port de l’hôte distant. Vous pouvez utiliser l’une Send des méthodes et Receive disponibles dans la Socket classe pour communiquer avec l’hôte distant. Lorsque vous avez terminé d’utiliser , Socketveillez à appeler sa Close méthode. Si votre application est relativement simple, envisagez d’utiliser la AcceptTcpClient méthode plutôt que la AcceptSocketAsync méthode . TcpClient vous fournit des méthodes simples pour envoyer et recevoir des données sur un réseau en mode synchrone bloquant.

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