TcpListener.AcceptTcpClientAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Przeciążenia

AcceptTcpClientAsync()	Akceptuje oczekujące żądanie połączenia jako operację asynchroniczną.
AcceptTcpClientAsync(CancellationToken)	Akceptuje oczekujące żądanie połączenia jako operację asynchroniczną z możliwością anulowania.

AcceptTcpClientAsync()

Źródło:

TCPListener.cs

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

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)

Zwraca

Task<TcpClient>

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

Wyjątki

InvalidOperationException

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

SocketException

ErrorCode Użyj właściwości , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwagi

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

TcpClient.GetStream Użyj metody , aby uzyskać element bazowy NetworkStream zwrócony TcpClient w obiekcie Task<TResult>. Program NetworkStream udostępnia metody wysyłania i odbierania z hostem zdalnym. W przypadku korzystania z metody TcpClientnależy wywołać metodę Close . Jeśli potrzebujesz większej elastyczności niż TcpClient oferty, rozważ użycie metody AcceptSocket lub AcceptSocketAsync.

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 jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez AcceptTcpClient()usługę .

Zobacz też

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Źródło:

TCPListener.cs

Akceptuje oczekujące żądanie połączenia jako operację asynchroniczną z możliwością anulowania.

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)

Parametry

cancellationToken

CancellationToken

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

Zwraca

ValueTask<TcpClient>

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

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

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

TcpClient.GetStream Użyj metody , aby uzyskać element bazowy NetworkStream zwrócony TcpClient w obiekcie Task<TResult>. Program NetworkStream udostępnia metody wysyłania i odbierania z hostem zdalnym. W przypadku korzystania z metody TcpClientnależy wywołać metodę Close . Jeśli potrzebujesz większej elastyczności niż TcpClient oferty, rozważ użycie metody AcceptSocket lub AcceptSocketAsync.

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 jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez AcceptTcpClient()usługę .