Udostępnij za pośrednictwem


TcpListener.AcceptTcpClientAsync Metoda

Definicja

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
Źródło:
TCPListener.cs
Ź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

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

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

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 programie .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ż

Dotyczy

AcceptTcpClientAsync(CancellationToken)

Źródło:
TCPListener.cs
Źródło:
TCPListener.cs
Ź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

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

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 programie .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ę .

Dotyczy