TcpListener.AcceptSocketAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Przeciążenia

AcceptSocketAsync()	Akceptuje oczekujące żądanie połączenia jako operację asynchroniczną.
AcceptSocketAsync(CancellationToken)	Akceptuje oczekujące żądanie połączenia jako anulowaną operację asynchroniczną.

AcceptSocketAsync()

Źródło:

TCPListener.cs

Akceptuje oczekujące żądanie połączenia jako operację asynchroniczną.

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)

Zwraca

Task<Socket>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca wartość używaną Socket do wysyłania i odbierania danych.

Wyjątki

InvalidOperationException

Odbiornik nie został uruchomiony z wywołaniem metody Start().

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po zaakceptowaniu połączenia gniazda.

Zwrócony Socket element jest Task<TResult> inicjowany przy użyciu adresu IP i numeru portu hosta zdalnego. Do komunikowania się z hostem zdalnym można użyć dowolnej metody Send i Receive dostępnej Socket w klasie . Po zakończeniu korzystania z metody należy wywołać metodę SocketClose . Jeśli aplikacja jest stosunkowo prosta, rozważ użycie AcceptTcpClient metody zamiast AcceptSocketAsync metody . TcpClient Udostępnia proste metody wysyłania i odbierania danych za pośrednictwem sieci w trybie synchronicznym blokującym.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AcceptSocket()usługę .

Zobacz też

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(CancellationToken)

Źródło:

TCPListener.cs

Akceptuje oczekujące żądanie połączenia jako anulowaną operację asynchroniczną.

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)

Parametry

cancellationToken

CancellationToken

Token anulowania, który może służyć do anulowania operacji asynchronicznej.

Zwraca

ValueTask<Socket>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca wartość używaną Socket do wysyłania i odbierania danych.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po zaakceptowaniu połączenia gniazda.

Zwrócony Socket element jest Task<TResult> inicjowany przy użyciu adresu IP i numeru portu hosta zdalnego. Do komunikowania się z hostem zdalnym można użyć dowolnej metody Send i Receive dostępnej Socket w klasie . Po zakończeniu korzystania z metody należy wywołać metodę SocketClose . Jeśli aplikacja jest stosunkowo prosta, rozważ użycie AcceptTcpClient metody zamiast AcceptSocketAsync metody . TcpClient Udostępnia proste metody wysyłania i odbierania danych za pośrednictwem sieci w trybie synchronicznym blokującym.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AcceptSocket()usługę .