UdpSingleSourceMulticastClient.BeginReceiveFromSource Метод

Определение

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

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 ^ 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

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

Атрибуты

ObsoleteAttribute

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

offset меньше 0.

-или-

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

-или-

count меньше 0.

-или-

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

InvalidOperationException

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

ObjectDisposedException

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

SocketException

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

Комментарии

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

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

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