Поделиться через


UdpSingleSourceMulticastClient.BeginReceiveFromSource Метод

Определение

Внимание!

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Начинает операцию получения пакета из присоединенной группы многоадресной рассылки и вызывает заданный обратный вызов при поступлении пакета в группу от указанного отправителя.

public:
 IAsyncResult ^ BeginReceiveFromSource(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public IAsyncResult BeginReceiveFromSource (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.BeginReceiveFromSource : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Параметры

buffer
Byte[]

Буфер для хранения полученных данных.

offset
Int32

Смещение в байтах от начала buffer, где должны храниться данные.

count
Int32

Максимальное число байтов для получения и сохранения в buffer.

callback
AsyncCallback

Метод обратного вызова, вызываемый после завершения операции.

state
Object

Необязательные сведения о состоянии для передачи в метод callback для этой операции.

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

IAsyncResult, который ссылается на эту операцию.

Атрибуты

Исключения

Параметр buffer является ссылкой на null (Nothing в Visual Basic).

offset меньше 0.

-или-

offset превышает длину buffer.

-или-

count меньше 0.

-или-

offset + количество превышает длину этого экземпляра buffer.

Группа многоадресной рассылки еще не присоединена.

Произошла ошибка при попытке доступа к сокету для получения.

Комментарии

Метод BeginReceiveFromSource начинает операцию получения пакета UDP из присоединенной группы многоадресной рассылки от одного отправителя. В конструкторе указываются локальный порт, группа многоадресной рассылки и исходный UdpSingleSourceMulticastClient адрес отправителя. Клиент многоадресной рассылки также должен завершить присоединение к группе многоадресной рассылки.

Метод, указанный в параметре callback , вызывается при получении пакета.

Сбой сокета может возникнуть, если операция получения завершается синхронно, хотя это редко встречается с UDP. При сбое сокета SocketException возникает исключение . Полученная ошибка указывается как член перечисления SocketError .

Применяется к