Socket.AcceptAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Przeciążenia

AcceptAsync()	Akceptuje połączenie przychodzące.
AcceptAsync(Socket)	Akceptuje połączenie przychodzące.
AcceptAsync(SocketAsyncEventArgs)	Rozpoczyna operację asynchroniczną, aby zaakceptować próbę połączenia przychodzącego.
AcceptAsync(CancellationToken)	Akceptuje połączenie przychodzące.
AcceptAsync(Socket, CancellationToken)	Akceptuje połączenie przychodzące.

AcceptAsync()

Źródło:

Socket.Tasks.cs

Akceptuje połączenie przychodzące.

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

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

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

Public Function AcceptAsync () As Task(Of Socket)

Zwraca

Task<Socket>

Asynchroniczne zadanie, które kończy się akceptowanym gniazdem.

Wyjątki

InvalidOperationException

Zażądano nieprawidłowej operacji. Ten wyjątek występuje, jeśli akceptowanie Socket nie nasłuchuje połączeń lub zaakceptowane gniazdo jest powiązane.

Przed wywołaniem metody i należy wywołać Bind(EndPoint) metodę AcceptAsync(SocketAsyncEventArgs) iListen(Int32).

Ten wyjątek występuje również wtedy, gdy gniazdo jest już połączone lub operacja gniazda była już w toku przy użyciu określonego e parametru.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

Uwagi

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 Accept()usługę .

AcceptAsync(Socket)

Źródło:

Socket.Tasks.cs

Akceptuje połączenie przychodzące.

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

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptAsync (System.Net.Sockets.Socket? acceptSocket);

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

Public Function AcceptAsync (acceptSocket As Socket) As Task(Of Socket)

Parametry

acceptSocket

Socket

Gniazdo do użycia do akceptowania połączenia.

Zwraca

Task<Socket>

Asynchroniczne zadanie, które kończy się akceptowanym gniazdem.

Wyjątki

InvalidOperationException

Zażądano nieprawidłowej operacji. Ten wyjątek występuje, jeśli akceptowanie Socket nie nasłuchuje połączeń lub zaakceptowane gniazdo jest powiązane.

Przed wywołaniem metody i należy wywołać Bind(EndPoint) metodę AcceptAsync(SocketAsyncEventArgs) iListen(Int32).

Ten wyjątek występuje również wtedy, gdy gniazdo jest już połączone lub operacja gniazda była już w toku przy użyciu określonego e parametru.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

AcceptAsync(SocketAsyncEventArgs)

Źródło:

Socket.cs

Rozpoczyna operację asynchroniczną, aby zaakceptować próbę połączenia przychodzącego.

public:
 bool AcceptAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool AcceptAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.AcceptAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function AcceptAsync (e As SocketAsyncEventArgs) As Boolean

Parametry

e

SocketAsyncEventArgs

Obiekt SocketAsyncEventArgs do użycia dla tej operacji asynchronicznego gniazda.

Zwraca

Boolean

true jeśli operacja we/wy jest oczekująca. Zdarzenie Completed parametru e zostanie podniesione po zakończeniu operacji.

false jeśli operacja we/wy została ukończona synchronicznie. Zdarzenie Completed parametru e nie zostanie podniesione, a e obiekt przekazany jako parametr może zostać zbadany natychmiast po powrocie wywołania metody w celu pobrania wyniku operacji.

Wyjątki

ArgumentException

Argument jest nieprawidłowy. Ten wyjątek występuje, jeśli podany bufor nie jest wystarczająco duży. Bufor musi mieć co najmniej 2 * (rozmiarof(SOCKADDR_STORAGE + 16 bajtów).

Ten wyjątek występuje również, jeśli określono wiele buforów, BufferList właściwość nie ma wartości null.

ArgumentOutOfRangeException

Argument jest poza zakresem. Wyjątek występuje, jeśli wartość Count jest mniejsza niż 0.

InvalidOperationException

Zażądano nieprawidłowej operacji. Ten wyjątek występuje, jeśli akceptowanie Socket nie nasłuchuje połączeń lub zaakceptowane gniazdo jest powiązane.

Przed wywołaniem metody i należy wywołać Bind(EndPoint) metodę AcceptAsync(SocketAsyncEventArgs) iListen(Int32).

Ten wyjątek występuje również wtedy, gdy gniazdo jest już połączone lub operacja gniazda była już w toku przy użyciu określonego e parametru.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

Uwagi

Protokoły zorientowane na połączenia mogą używać AcceptAsync metody do asynchronicznego przetwarzania prób połączenia przychodzącego. Akceptowanie połączeń asynchronicznie umożliwia wysyłanie i odbieranie danych w osobnym wątku wykonywania. Przed wywołaniem metody należy wywołać metodę AcceptAsyncListen , aby nasłuchiwać żądań połączeń przychodzących i kolejkować je.

Aby otrzymywać powiadomienia o zakończeniu, należy utworzyć metodę wywołania zwrotnego, która implementuje delegata EventHandler<SocketAsyncEventArgs> i podłączyć go do SocketAsyncEventArgs.Completed zdarzenia.

Wymagane są następujące właściwości i zdarzenia obiektu System.Net.Sockets.SocketAsyncEventArgs :

• SocketAsyncEventArgs.Completed

Obiekt wywołujący może opcjonalnie określić istniejący Socket element do użycia dla połączenia przychodzącego, określając Socket wartość do użycia z właściwością SocketAsyncEventArgs.AcceptSocket .

SocketAsyncEventArgs.AcceptSocket Jeśli właściwość ma wartość null, nowa Socket jest konstruowana z tym samym AddressFamilyelementem , SocketTypei ProtocolType co bieżąca Socket i ustawiona jako SocketAsyncEventArgs.AcceptSocket właściwość .

Obiekt wywołujący może ustawić SocketAsyncEventArgs.UserToken właściwość na dowolny obiekt stanu użytkownika żądany przed wywołaniem AcceptAsync metody, aby informacje mogły zostać pobrane w metodzie wywołania zwrotnego. Jeśli wywołanie zwrotne wymaga więcej informacji niż pojedynczy obiekt, można utworzyć małą klasę, aby przechowywać inne wymagane informacje o stanie jako elementy członkowskie.

Opcjonalnie po pomyślnym zakończeniu ConnectAsync metody można podać bufor, w którym można odbierać początkowy blok danych na gniazdach. W takim przypadku SocketAsyncEventArgs.Buffer właściwość musi być ustawiona na bufor zawierający dane do odbierania, a SocketAsyncEventArgs.Count właściwość musi być ustawiona na maksymalną liczbę bajtów danych do odbierania w buforze. Te właściwości można ustawić przy użyciu SocketAsyncEventArgs.SetBuffer metody . Część buforu przekazanego zostanie użyta wewnętrznie do użycia przez bazowe wywołanie Winsock AcceptEx. Oznacza to, że ilość zwróconych danych będzie zawsze mniejsza niż wartość SocketAsyncEventArgs.Count właściwości podanej w wystąpieniu System.Net.Sockets.SocketAsyncEventArgs . Ilość buforu używanego wewnętrznie zależy od rodziny adresów gniazda. Wymagany minimalny rozmiar buforu to 288 bajtów. Jeśli zostanie określony większy rozmiar buforu, Socket będzie oczekiwać dodatkowych danych innych niż dane adresowe odebrane przez wywołanie Winsock AcceptEx i zaczeka na odebranie dodatkowych danych. Jeśli wystąpi przekroczenie limitu czasu, połączenie zostanie zresetowane. Jeśli więc oczekiwane są dodatkowe dane o określonej ilości, rozmiar buforu powinien zostać ustawiony na minimalny rozmiar buforu i tę kwotę.

Metoda wywołania zwrotnego ukończenia powinna zbadać właściwość, SocketAsyncEventArgs.SocketError aby określić, czy AcceptAsync operacja zakończyła się pomyślnie.

Zdarzenie SocketAsyncEventArgs.Completed może wystąpić w niektórych przypadkach, gdy żadne połączenie nie zostało zaakceptowane i powoduje SocketAsyncEventArgs.SocketError ustawienie właściwości na ConnectionReset. Może to nastąpić w wyniku skanowania portów przy użyciu pół otwartego skanowania typu SYN (sekwencja SYN -> SYN-ACK -> RST). Aplikacje korzystające z AcceptAsync metody powinny być przygotowane do obsługi tego warunku.

Zobacz też

• SocketAsyncEventArgs
• AcceptSocket
• Buffer
• Completed
• Count
• UserToken

AcceptAsync(CancellationToken)

Źródło:

Socket.Tasks.cs

Akceptuje połączenie przychodzące.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptAsync(System::Threading::CancellationToken cancellationToken);

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

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

Public Function AcceptAsync (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>

Asynchroniczne zadanie, które kończy się akceptowanym gniazdem.

Wyjątki

InvalidOperationException

Zażądano nieprawidłowej operacji. Ten wyjątek występuje, jeśli akceptowanie Socket nie nasłuchuje połączeń lub zaakceptowane gniazdo jest powiązane.

Przed wywołaniem metody i należy wywołać Bind(EndPoint) metodę AcceptAsync(SocketAsyncEventArgs) iListen(Int32).

Ten wyjątek występuje również wtedy, gdy gniazdo jest już połączone lub operacja gniazda była już w toku przy użyciu określonego e parametru.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

OperationCanceledException

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

Uwagi

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 Accept()usługę .

AcceptAsync(Socket, CancellationToken)

Źródło:

Socket.Tasks.cs

Akceptuje połączenie przychodzące.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptAsync(System::Net::Sockets::Socket ^ acceptSocket, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptAsync (System.Net.Sockets.Socket? acceptSocket, System.Threading.CancellationToken cancellationToken);

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

Public Function AcceptAsync (acceptSocket As Socket, cancellationToken As CancellationToken) As ValueTask(Of Socket)

Parametry

acceptSocket

Socket

Gniazdo do użycia do akceptowania połączenia.

cancellationToken

CancellationToken

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

Zwraca

ValueTask<Socket>

Asynchroniczne zadanie, które kończy się akceptowanym gniazdem.

Wyjątki

InvalidOperationException

Zażądano nieprawidłowej operacji. Ten wyjątek występuje, jeśli akceptowanie Socket nie nasłuchuje połączeń lub zaakceptowane gniazdo jest powiązane.

Przed wywołaniem metody i należy wywołać Bind(EndPoint) metodę AcceptAsync(SocketAsyncEventArgs) iListen(Int32).

Ten wyjątek występuje również wtedy, gdy gniazdo jest już połączone lub operacja gniazda była już w toku przy użyciu określonego e parametru.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

OperationCanceledException

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