UdpSingleSourceMulticastClient.BeginReceiveFromSource Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.dll

Perhatian

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Memulai operasi menerima paket dari grup multicast yang bergabung dan memanggil panggilan balik yang ditentukan ketika paket telah tiba di grup dari pengirim tertentu.

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

Parameter

buffer

Byte[]

Buffer untuk menyimpan data yang diterima.

offset

Int32

Offset, dalam byte, dari awal buffer tempat data harus disimpan.

count

Int32

Jumlah maksimum byte yang akan diterima dan disimpan di buffer.

callback

AsyncCallback

Metode panggilan balik untuk dipanggil ketika operasi selesai.

state

Object

Informasi status opsional untuk diteruskan ke callback metode untuk operasi ini.

Mengembalikan

IAsyncResult

Yang IAsyncResult mereferensikan operasi ini.

Atribut

ObsoleteAttribute

Pengecualian

ArgumentNullException

buffer adalah referensi null (Tidak ada di Visual Basic).

ArgumentOutOfRangeException

offset kurang dari 0

-atau-

offset lebih besar dari panjang buffer.

-atau-

count kurang dari 0

-atau-

offset ditambah jumlahnya lebih besar dari panjang buffer.

InvalidOperationException

Grup multicast belum bergabung.

ObjectDisposedException

Sudah UdpSingleSourceMulticastClient dibuang.

SocketException

Terjadi kesalahan saat mencoba mengakses soket untuk menerima.

Keterangan

Metode ini BeginReceiveFromSource memulai operasi menerima paket UDP dari grup multicast yang bergabung dari satu pengirim. Port lokal, grup multicast, dan alamat sumber pengirim ditentukan dalam UdpSingleSourceMulticastClient konstruktor. Klien multicast juga harus telah menyelesaikan gabungan ke grup multicast.

Metode yang ditentukan dalam callback parameter dipanggil ketika paket telah diterima.

Dimungkinkan untuk mengalami kegagalan soket jika operasi penerima gagal secara sinkron, meskipun ini jarang terjadi dengan UDP. Jika kegagalan soket terjadi, akan SocketException dilemparkan. Kesalahan yang diterima ditentukan sebagai anggota SocketError enumerasi.