UdpAnySourceMulticastClient.BeginSendTo Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.dll

Dikkat

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

Belirtilen hedefe tek noktaya yayın paketi gönderme işlemini başlatır.

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

Parametreler

buffer

Byte[]

Gönderilecek verileri içeren arabellek.

offset

Int32

Gönderilecek verileri okumak için başından itibaren bayt buffer cinsinden uzaklık.

count

Int32

'den buffergönderilecek bayt sayısı.

remoteEndPoint

IPEndPoint

Paketin gönderileceği uzak uç nokta.

callback

AsyncCallback

İşlem tamamlandığında çağrılacak geri çağırma yöntemi.

state

Object

Bu işlemin yöntemine geçirebilmek callback için isteğe bağlı durum bilgileri.

Döndürülenler

IAsyncResult

IAsyncResult Bu işleme başvuran bir.

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

buffer null başvurudur (Visual Basic'te hiçbir şey yoktur).

ArgumentOutOfRangeException

offset 0'dan küçük

-veya-

offset değerinin uzunluğundan büyük olması gerekir buffer.

-veya-

count 0'dan küçük

-veya-

offset artı sayı değerinin uzunluğundan bufferbüyük olmasıdır.

InvalidOperationException

Çok noktaya yayın grubu henüz katılmadı.

ObjectDisposedException

UdpAnySourceMulticastClient yok edildi.

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

Açıklamalar

yöntemi, BeginSendTo birleştirilen çok noktaya yayın grubuna bir UDP paketi gönderme işlemini başlatır.

İstemcinin çok noktaya yayın grubuna katılımı tamamlamış olması gerekir. parametresinde belirtilen hedef adresin remoteEndPoint bu alıcıya zaten bir çok noktaya yayın paketi göndermiş olması gerekir. Bazı protokoller akış denetimi, hizmet kalitesi istatistikleri veya kurtarma iletilerini geçirmek için bu bilgileri kullanır.

parametresinde callback belirtilen yöntem, bir paket alındığında çağrılır.

İletime yalnızca parametresinde remoteEndPoint belirtilen adres bu alıcıya zaten bir çok noktaya yayın paketi gönderdiyse izin verilir. İstemcinin erişimine izin verilmiyorsa, ile AccessDeniedbir SocketException oluşturulur.

parametresinde remoteEndPoint belirtilen hedef bağlantı noktası 1.024'ten küçükse, ile AccessDeniedbir SocketException oluşturulur.

Udp ile sık rastlanmayan bir işlem olsa da, alma işlemi zaman uyumlu olarak başarısız olursa yuva hatası olması mümkündür. Yuva hatası oluşursa, bir SocketException oluşturulur. Alınan hata, numaralandırmanın SocketError bir üyesi olarak belirtilir.