Socket.BeginSendTo Метод

public:
 IAsyncResult ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginSendTo(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendTo(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP, AsyncCallback callback, object state);

member this.BeginSendTo : byte[] * int * int * System.Net.Sockets.SocketFlags * System.Net.EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendTo (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Параметры

Возвращаемое значение

Объект, IAsyncResult ссылающийся на асинхронную отправку.

Исключения

Комментарии

Вы можете передать обратный вызов, который реализуется AsyncCallbackBeginSendTo для получения уведомлений о завершении операции. Обратите внимание, что если базовый сетевой стек завершает операцию синхронно, обратный вызов будет выполняться во время вызова BeginSendTo. В этом случае CompletedSynchronously для возвращаемого IAsyncResult свойства будет задано true значение, указывающее, что метод завершился синхронно. AsyncState Используйте свойство IAsyncResult объекта состояния, переданного методуBeginSendTo.

Операция BeginSendTo должна быть завершена EndSendTo путем вызова метода. Как правило, метод вызывается предоставленным AsyncCallback делегатом. EndSendTo блокирует вызывающий поток до завершения операции.

Если вы используете протокол, ориентированный на подключение, необходимо сначала вызвать Connectметод , BeginConnectAcceptили BeginAccept метод или BeginSendTo вызвать SocketException. BeginSendToбудет игнорировать remoteEP параметр и отправлять данные в установленный EndPointConnectBeginConnectAcceptв , или BeginAccept метод.

Если вы используете протокол без подключения, вам не нужно устанавливать удаленный узел по умолчанию с Connect помощью метода или BeginConnect метода перед вызовом SendTo. Это необходимо сделать только в том случае, если вы планируете вызвать BeginSend метод. При вызове Connect метода или BeginConnect метода перед вызовом SendToremoteEP параметр переопределит указанный удаленный узел по умолчанию только для этой операции отправки. Для вызова Bind метода также не требуется. В этом случае базовый поставщик услуг назначит наиболее подходящий адрес локальной сети и номер порта. Используйте номер порта в нуле, если требуется, чтобы базовый поставщик услуг использовал бесплатный порт. Если необходимо определить назначенный адрес локальной сети и номер порта, можно использовать LocalEndPoint свойство после успешного EndSendTo завершения метода.

Если вы хотите отправить данные на широковещательный адрес, необходимо сначала вызвать SetSocketOption метод и задать для него параметр SocketOptionName.Broadcastсокета. -Необходимо также убедиться, что размер буфера не превышает максимальный размер пакета базового поставщика услуг. Если это так, то диаграмма данных не будет отправлена EndSendToи SocketException вызовет исключение.

Если в качестве DontRoute параметра указать socketflags флаг, то отправляемые данные не будут перенаправлены.

См. также раздел

• EndSendTo(IAsyncResult)
• AsyncCallback
• Connect(EndPoint)
• LocalEndPoint
• Broadcast
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• Маршалинг делегата в качестве метода обратного вызова