UdpClient.ReceiveAsync Метод

Определение

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

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

Перегрузки

ReceiveAsync()	Асинхронно возвращает UDP-датаграмму, которая была послана на удаленный узел.
ReceiveAsync(CancellationToken)	Асинхронно возвращает UDP-датаграмму, которая была послана на удаленный узел.

ReceiveAsync()

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

UDPClient.cs

Асинхронно возвращает UDP-датаграмму, которая была послана на удаленный узел.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::UdpReceiveResult> ^ ReceiveAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.UdpReceiveResult> ReceiveAsync ();

member this.ReceiveAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.UdpReceiveResult>

Public Function ReceiveAsync () As Task(Of UdpReceiveResult)

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

Task<UdpReceiveResult>

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

Исключения

ObjectDisposedException

Основной объект Socket закрыт.

SocketException

Произошла ошибка при обращении к сокету.

Комментарии

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

Если в методе Connect указать удаленный узел по умолчанию, этот метод будет принимать датаграммы только от этого узла. Все остальные датаграммы будут удалены.

Если вы получаете SocketException, используйте SocketException.ErrorCode для получения определенного кода ошибки. Получив этот код, вы можете ознакомиться с документацией по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

Предупреждение

Если вы планируете получать многоадресные датаграммы, не вызывайте Connect метод до вызова этого метода. Объект , используемый UdpClient для получения датаграмм, должен быть создан с использованием номера порта многоадресной рассылки.

ReceiveAsync(CancellationToken)

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

UDPClient.cs

Асинхронно возвращает UDP-датаграмму, которая была послана на удаленный узел.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::UdpReceiveResult> ReceiveAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.UdpReceiveResult> ReceiveAsync (System.Threading.CancellationToken cancellationToken);

member this.ReceiveAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.UdpReceiveResult>

Public Function ReceiveAsync (cancellationToken As CancellationToken) As ValueTask(Of UdpReceiveResult)

Параметры

cancellationToken

CancellationToken

Токен для отслеживания запросов отмены.

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

ValueTask<UdpReceiveResult>

ValueTask<TResult>, представляющий асинхронную операцию.

Исключения

ObjectDisposedException

Основной объект Socket закрыт.

SocketException

Произошла ошибка при обращении к сокету.

OperationCanceledException

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