UdpSingleSourceMulticastClient.BeginSendToSource 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 sumber yang ditentukan sebelumnya.

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

Public Function BeginSendToSource (buffer As Byte(), offset As Integer, count As Integer, remotePort As Integer, 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.

remotePort

Int32

Port jarak jauh tempat paket akan dikirim. Alamat jarak jauh ditentukan oleh UdpSingleSourceMulticastClient(IPAddress, IPAddress, Int32) konstruktor.

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.

-atau-

remotePort kurang dari 0 atau lebih besar dari 65.535.

InvalidOperationException

Grup multicast belum bergabung.

ObjectDisposedException

Sudah UdpSingleSourceMulticastClient dibuang.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

Keterangan

Metode ini BeginSendToSource memulai operasi pengiriman paket UDP ke sumber yang ditentukan sebelumnya.

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

Klien harus telah menyelesaikan gabungan ke grup multicast.

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

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