UdpSingleSourceMulticastClient.BeginSendToSource Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание!
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Начинает операцию отправки одноадресного пакета в предварительно указанный источник.
public:
IAsyncResult ^ BeginSendToSource(cli::array <System::Byte> ^ buffer, int offset, int count, int remotePort, 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 BeginSendToSource (byte[] buffer, int offset, int count, int remotePort, 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.BeginSendToSource : byte[] * int * int * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginSendToSource (buffer As Byte(), offset As Integer, count As Integer, remotePort As Integer, callback As AsyncCallback, state As Object) As IAsyncResult
Параметры
- buffer
- Byte[]
Буфер, содержащий данные для отправки.
- offset
- Int32
Смещение в байтах от начала buffer
для чтения отправляемых данных.
- count
- Int32
Количество байтов, которые необходимо отправить из buffer
.
- remotePort
- Int32
Удаленный порт, в который нужно отправить пакет. Этот удаленный адрес задается конструктором UdpSingleSourceMulticastClient(IPAddress, IPAddress, Int32).
- callback
- AsyncCallback
Метод обратного вызова, вызываемый после завершения операции.
- state
- Object
Необязательные сведения о состоянии для передачи в метод callback
для этой операции.
Возвращаемое значение
IAsyncResult, который ссылается на эту операцию.
- Атрибуты
Исключения
Параметр buffer
является ссылкой на null (Nothing в Visual Basic).
offset
меньше 0.
-или-
offset
превышает длину buffer
.
-или-
count
меньше 0.
-или-
offset
+ количество превышает длину этого экземпляра buffer
.
-или-
Параметр remotePort
имеет значение меньше 0 или больше 65 535.
Группа многоадресной рассылки еще не присоединена.
Объект UdpSingleSourceMulticastClient удален.
Произошла ошибка при попытке доступа к сокету.
Комментарии
Метод BeginSendToSource начинает операцию отправки UDP-пакета в ранее указанный источник.
Некоторые протоколы используют эти сведения для передачи управления потоком, статистики качества обслуживания или сообщений о восстановлении.
Метод, указанный в параметре callback
, вызывается при отправке пакета.
Клиент должен завершить присоединение к группе многоадресной рассылки.
Если порт назначения, указанный в параметре remotePort
, меньше 1024, SocketException создается с AccessDenied.
При синхронном сбое операции отправки может возникнуть сбой сокета, хотя это редко встречается с UDP. При сбое сокета SocketException возникает исключение . Полученная ошибка указывается как член перечисления SocketError .