UdpAnySourceMulticastClient.BeginSendTo 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 pengiriman paket unicast ke tujuan yang ditentukan.

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

Parameter

buffer

Byte[]

Buffer yang berisi data yang akan dikirim.

offset

Int32

Offset, dalam byte, dari awal buffer hingga membaca data yang akan dikirim.

count

Int32

Jumlah byte yang akan dikirim dari buffer.

remoteEndPoint

IPEndPoint

Titik akhir jarak jauh tempat paket akan dikirim.

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 digabungkan.

ObjectDisposedException

UdpAnySourceMulticastClient Telah dibuang.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

Keterangan

Metode ini BeginSendTo memulai operasi pengiriman paket UDP ke grup multicast yang bergabung.

Klien harus telah menyelesaikan gabungan ke grup multicast. Alamat tujuan yang ditentukan dalam remoteEndPoint parameter harus sudah mengirim paket multicast ke penerima ini. Beberapa protokol menggunakan informasi ini untuk meneruskan kontrol alur, kualitas statistik layanan, atau pesan pemulihan.

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

Transmisi hanya diperbolehkan jika alamat yang ditentukan dalam remoteEndPoint parameter telah mengirim paket multicast ke penerima ini. Jika klien tidak diizinkan mengakses, akan SocketException dilemparkan dengan AccessDenied.

Jika port tujuan yang ditentukan dalam remoteEndPoint parameter kurang dari 1.024, akan SocketException dilemparkan dengan AccessDenied.

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