UdpSingleSourceMulticastClient.BeginReceiveFromSource Metodo

Definizione

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 un pacchetto è arrivato sul gruppo da un mittente specificato.

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

Parametri

buffer
Byte[]

Buffer in cui archiviare i dati ricevuti.

offset
Int32

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

count
Int32

Numero massimo di byte da ricevere e archiviare in buffer.

callback
AsyncCallback

Metodo di callback da richiamare al termine dell'operazione.

state
Object

Informazioni facoltative sullo stato da passare al callback metodo per questa operazione.

Valori restituiti

Oggetto IAsyncResult che fa riferimento a questa operazione.

Attributi

Eccezioni

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

offset è minore di 0

oppure

offset è maggiore della lunghezza dell'oggetto buffer.

oppure

count è minore di 0

oppure

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

Il gruppo multicast non è ancora stato unito.

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

Commenti

Il BeginReceiveFromSource metodo avvia un'operazione di ricezione di un pacchetto UDP dal gruppo multicast unito da un singolo mittente. La porta locale, il gruppo multicast e l'indirizzo UdpSingleSourceMulticastClient di origine del mittente vengono specificati nel costruttore. Il client multicast deve anche aver completato un join al gruppo multicast.

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

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

Si applica a