UdpAnySourceMulticastClient.BeginReceiveFromGroup Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.dll

Upozornění

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

Zahájí operaci příjmu paketu z připojené skupiny vícesměrového vysílání a vyvolá zadanou zpětné volání, když paket do skupiny dorazí od libovolného odesílatele.

public:
 IAsyncResult ^ BeginReceiveFromGroup(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 BeginReceiveFromGroup (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.BeginReceiveFromGroup : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveFromGroup (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

buffer

Byte[]

Vyrovnávací paměť pro uložení přijatých dat.

offset

Int32

Posun v bajtech od začátku buffer místa, kde mají být data uložena.

count

Int32

Maximální počet bajtů, které se mají přijmout a uložit v .buffer

callback

AsyncCallback

Metoda zpětného volání, která se má vyvolat po dokončení operace.

state

Object

Volitelné informace o stavu, které se mají předat callback metodě pro tuto operaci.

Návraty

IAsyncResult

Objekt IAsyncResult , který odkazuje na tuto operaci.

Atributy

ObsoleteAttribute

Výjimky

ArgumentNullException

buffer je odkaz s hodnotou null (Nothing v jazyce Visual Basic).

ArgumentOutOfRangeException

offset je menší než 0

-nebo-

offset je větší než délka buffer.

-nebo-

count je menší než 0

-nebo-

offsetplus počet je větší než délka .buffer

InvalidOperationException

Skupina vícesměrového vysílání ještě nebyla připojena.

ObjectDisposedException

Byla UdpAnySourceMulticastClient zlikvidována.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

Poznámky

Metoda BeginReceiveFromGroup zahájí operaci přijetí paketu UDP z připojené skupiny vícesměrového vysílání od libovolného odesílatele. Místní port a adresa skupiny vícesměrového vysílání jsou zadány v konstruktoru UdpAnySourceMulticastClient . Klient vícesměrového vysílání také musí mít dokončené připojení ke skupině vícesměrového vysílání.

Metoda zadaná v parametru callback je vyvolána při přijetí paketu.

Pokud operace příjmu selže synchronně, může dojít k selhání soketu, i když to u protokolu UDP není obvyklé. Pokud dojde k selhání soketu, vyvolá se SocketException chyba . Přijatá chyba je určena jako člen výčtu SocketError .