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 参照です (Visual Basicでは Nothing)。

ArgumentOutOfRangeException

offset が 0 未満です

-又は-

offset が bufferの長さを超えています。

-又は-

count が 0 未満です

-又は-

offset とカウントが bufferの長さを超えています。

InvalidOperationException

マルチキャスト グループはまだ参加していません。

ObjectDisposedException

UdpAnySourceMulticastClientが破棄されました。

SocketException

ソケットにアクセスしようとしたときにエラーが発生しました。

注釈

BeginSendTo メソッドは、参加しているマルチキャスト グループに UDP パケットを送信する操作を開始します。

クライアントはマルチキャスト グループへの参加を完了している必要があります。 remoteEndPoint パラメーターで指定された宛先アドレスは、この受信側にマルチキャスト パケットを既に送信している必要があります。 一部のプロトコルでは、この情報を使用して、フロー制御、サービスの品質統計、または回復メッセージを渡します。

callback パラメーターで指定されたメソッドは、パケットを受信したときに呼び出されます。

送信は、 remoteEndPoint パラメーターで指定されたアドレスがこの受信側にマルチキャスト パケットを既に送信している場合にのみ許可されます。 クライアントがアクセスを許可されていない場合は、SocketExceptionを使用してAccessDeniedがスローされます。

remoteEndPoint パラメーターで指定された宛先ポートが 1,024 未満の場合は、SocketExceptionでAccessDeniedがスローされます。

受信操作が同期的に失敗した場合、ソケットエラーが発生する可能性がありますが、これは UDP では一般的ではありません。 ソケットエラーが発生すると、 SocketException がスローされます。 受信したエラーは、 SocketError 列挙体のメンバーとして指定されます。

適用対象