UdpAnySourceMulticastClient.BeginReceiveFromGroup Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.dll

Attenzione

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

Avvia l'operazione di ricezione di un pacchetto dal gruppo multicast unito e richiama il callback specificato quando arriva un pacchetto per il gruppo da qualsiasi mittente.

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

Parametri

buffer

Byte[]

Buffer per archiviare i dati ricevuti.

offset

Int32

Offset, in byte, dall'inizio del buffer in cui devono essere archiviati i dati.

count

Int32

Numero massimo di byte da ricevere e archiviare nel buffer.

callback

AsyncCallback

Metodo di callback da richiamare al completamento dell'operazione.

state

Object

Informazioni di stato facoltative da passare al metodo callback per l'operazione.

Restituisce

IAsyncResult

IAsyncResult che fa riferimento a questa operazione.

Attributi

ObsoleteAttribute

Eccezioni

ArgumentNullException

buffer è un riferimento null (Nothing in Visual Basic).

ArgumentOutOfRangeException

offset è minore di 0.

-oppure-

offset è maggiore della lunghezza di buffer.

-oppure-

count è minore di 0.

-oppure-

offset più il conteggio è maggiore della lunghezza di buffer.

InvalidOperationException

Il gruppo multicast non è ancora stato unito.

ObjectDisposedException

L'interfaccia UdpAnySourceMulticastClient è stata eliminata.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

Commenti

Il BeginReceiveFromGroup metodo avvia un'operazione di ricezione di un pacchetto UDP dal gruppo multicast unito da qualsiasi mittente. La porta locale e l'indirizzo del gruppo multicast vengono specificati nel UdpAnySourceMulticastClient costruttore. Anche il client multicast deve aver completato un join al gruppo multicast.

Il metodo specificato nel callback parametro viene richiamato quando viene ricevuto un pacchetto.

È possibile che si verifichi un errore del socket se un'operazione di ricezione non riesce in modo sincrono, anche se questa operazione non è comune con UDP. Se si verifica un errore del socket, viene generata un'eccezione SocketException . L'errore ricevuto viene specificato come membro dell'enumerazione SocketError .