UdpAnySourceMulticastClient.BeginReceiveFromGroup Метод

  • Ссылка

Определение

Пространство имен:
System.Net.Sockets
Сборка:
System.Net.dll

Внимание!

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

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

Атрибуты
ObsoleteAttribute

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

offset меньше 0.

-или-

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

-или-

count меньше 0.

-или-

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

InvalidOperationException

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

ObjectDisposedException

Объект UdpAnySourceMulticastClient удален.

SocketException

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

Комментарии

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

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

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

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