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 является пустой ссылкой (Ничего в Visual Basic).

ArgumentOutOfRangeException

offset меньше 0

–или–

offset больше длины buffer.

–или–

count меньше 0

–или–

offset плюс число больше длины buffer.

InvalidOperationException

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

ObjectDisposedException

Он UdpAnySourceMulticastClient был удален.

SocketException

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

Комментарии

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

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

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

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