TcpListener.AcceptSocketAsync Метод

Определение

Пространство имен:

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Перегрузки

Имя	Описание
AcceptSocketAsync()	Принимает ожидающий запрос на подключение в качестве асинхронной операции.
AcceptSocketAsync(CancellationToken)	Принимает ожидающий запрос на подключение в качестве отменяемой асинхронной операции.

AcceptSocketAsync()

Исходный код:

TCPListener.cs

Принимает ожидающий запрос на подключение в качестве асинхронной операции.

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)

Возвращаемое значение

Task<Socket>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает используемый Socket для отправки и получения данных.

Исключения

InvalidOperationException

Прослушиватель не был запущен с вызовом Start().

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после принятия подключения сокета.

Возвращаемый Socket объект Task<TResult> инициализируется с IP-адресом и номером порта удаленного узла. Для взаимодействия с удаленным узлом можно использовать любой из SendReceive методов, доступных в Socket классе. После завершения работы с методом Socketобязательно вызовите его Close метод. Если приложение относительно просто, рекомендуется использовать AcceptTcpClient метод, а не AcceptSocketAsync метод. TcpClient предоставляет простые методы для отправки и получения данных через сеть в блокирующей синхронном режиме.

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых AcceptSocket().

См. также раздел

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(CancellationToken)

Исходный код:

TCPListener.cs

Принимает ожидающий запрос на подключение в качестве отменяемой асинхронной операции.

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)

Параметры

cancellationToken

CancellationToken

Маркер отмены, который можно использовать для отмены асинхронной операции.

Возвращаемое значение

ValueTask<Socket>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает используемый Socket для отправки и получения данных.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после принятия подключения сокета.

Возвращаемый Socket объект Task<TResult> инициализируется с IP-адресом и номером порта удаленного узла. Для взаимодействия с удаленным узлом можно использовать любой из SendReceive методов, доступных в Socket классе. После завершения работы с методом Socketобязательно вызовите его Close метод. Если приложение относительно просто, рекомендуется использовать AcceptTcpClient метод, а не AcceptSocketAsync метод. TcpClient предоставляет простые методы для отправки и получения данных через сеть в блокирующей синхронном режиме.

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых AcceptSocket().