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


UdpAnySourceMulticastClient.BeginReceiveFromGroup Метод

Определение

Внимание!

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

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

public:
 IAsyncResult ^ BeginReceiveFromGroup(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 BeginReceiveFromGroup (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.BeginReceiveFromGroup : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginReceiveFromGroup (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.

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

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

Комментарии

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

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

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

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