Udostępnij za pośrednictwem


TcpListener.AcceptSocketAsync Metoda

Definicja

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
Ź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::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

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

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ż

Dotyczy

AcceptSocketAsync(CancellationToken)

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

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

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

Dotyczy