UdpAnySourceMulticastClient.BeginReceiveFromGroup メソッド

定義

名前空間:

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

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

パラメーター

buffer

Byte[]

受信したデータを格納するバッファー。

offset

Int32

データの保存先になる、buffer の先頭からのバイト単位のオフセット。

count

Int32

buffer で受信および格納するバイトの最大数。

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

ソケットへのアクセスを試行しているときにエラーが発生しました。

注釈

メソッドは BeginReceiveFromGroup 、任意の送信者から参加しているマルチキャスト グループから UDP パケットを受信する操作を開始します。 ローカル ポートとマルチキャスト グループ アドレスは、コンストラクターで UdpAnySourceMulticastClient 指定されます。 マルチキャスト クライアントは、マルチキャスト グループへの参加も完了している必要があります。

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

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