UdpSingleSourceMulticastClient.BeginReceiveFromSource メソッド

定義

名前空間:

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 ^ BeginReceiveFromSource(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 BeginReceiveFromSource (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.BeginReceiveFromSource : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveFromSource (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

UdpSingleSourceMulticastClient は破棄されています。

SocketException

受信のためにソケットにアクセスしようとして、エラーが発生しました。

注釈

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

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

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