Bagikan melalui

UdpAnySourceMulticastClient.BeginSendTo Metode

  • Referensi

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.

Berlaku untuk