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 メンバーとして指定されます。