UdpSingleSourceMulticastClient.BeginReceiveFromSource Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.dll

Przestroga

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

Rozpoczyna operację odbierania pakietu z przyłączonej grupy multiemisji i wywołuje określone wywołanie zwrotne, gdy pakiet przybył do grupy od określonego nadawcy.

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

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

Parametry

buffer

Byte[]

Bufor do przechowywania odebranych danych.

offset

Int32

Przesunięcie (w bajtach) od początku buffer miejsca przechowywania danych.

count

Int32

Maksymalna liczba bajtów do odbierania i przechowywania w obiekcie buffer.

callback

AsyncCallback

Metoda wywołania zwrotnego, która ma być wywoływana po zakończeniu operacji.

state

Object

Opcjonalne informacje o stanie do przekazania do callback metody dla tej operacji.

Zwraca

IAsyncResult

Obiekt IAsyncResult , który odwołuje się do tej operacji.

Atrybuty

ObsoleteAttribute

Wyjątki

ArgumentNullException

buffer jest odwołaniem o wartości null (Nic w Visual Basic).

ArgumentOutOfRangeException

offset jest mniejsza niż 0

-lub-

offset jest większa niż długość obiektu buffer.

-lub-

count jest mniejsza niż 0

-lub-

offsetplus liczba jest większa niż długość .buffer

InvalidOperationException

Grupa multiemisji nie została jeszcze dołączona.

ObjectDisposedException

Element UdpSingleSourceMulticastClient został usunięty.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda do odbierania.

Uwagi

Metoda BeginReceiveFromSource rozpoczyna operację odbierania pakietu UDP z przyłączonej grupy multiemisji od jednego nadawcy. W konstruktorze określono port lokalny, grupę UdpSingleSourceMulticastClient multiemisji i adres źródłowy nadawcy. Klient multiemisji musi również ukończyć sprzężenie do grupy multiemisji.

Metoda określona w parametrze callback jest wywoływana po odebraniu pakietu.

Istnieje możliwość wystąpienia błędu gniazda, jeśli operacja odbierania nie powiedzie się synchronicznie, chociaż jest to rzadkością w przypadku protokołu UDP. W przypadku wystąpienia błędu SocketException gniazda zgłaszany jest błąd . Odebrany błąd jest określony jako element członkowski SocketError wyliczenia.