UdpAnySourceMulticastClient.BeginSendTo Метод

Определение

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

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 ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int count, System::Net::IPEndPoint ^ remoteEndPoint, 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 BeginSendTo (byte[] buffer, int offset, int count, System.Net.IPEndPoint remoteEndPoint, 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.BeginSendTo : byte[] * int * int * System.Net.IPEndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Параметры

buffer

Byte[]

Буфер, содержащий данные для отправки.

offset

Int32

Смещение в байтах от начала buffer для чтения отправляемых данных.

count

Int32

Количество байтов, которые необходимо отправить из buffer.

remoteEndPoint

IPEndPoint

Удаленная конечная точка, в которую нужно отправить пакет.

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

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

Комментарии

Метод BeginSendTo начинает операцию отправки пакета UDP в присоединенную группу многоадресной рассылки.

Клиент должен завершить присоединение к группе многоадресной рассылки. Адрес назначения, указанный в параметре remoteEndPoint , должен уже отправить этому получателю пакет многоадресной рассылки. Некоторые протоколы используют эти сведения для передачи управления потоком, статистики качества обслуживания или сообщений о восстановлении.

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

Передача разрешена только в том случае, если адрес, указанный в параметре remoteEndPoint , уже отправил этому получателю пакет многоадресной рассылки. Если клиенту не разрешен доступ, SocketException возникает исключение с AccessDenied.

Если порт назначения, указанный в параметре remoteEndPoint , меньше 1024, SocketException создается с AccessDenied.

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