Lingua

UdpAnySourceMulticastClient.BeginSendTo 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 invio di un pacchetto unicast alla destinazione specificata.

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

Parametri

buffer
Byte[]

Buffer che contiene i dati da inviare.

offset
Int32

Offset, in byte, dall'inizio di buffer per leggere i dati da inviare.

count
Int32

Numero di byte da inviare da buffer.

remoteEndPoint
IPEndPoint

Endpoint remoto a cui inviare il pacchetto.

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.

Commenti

Il BeginSendTo metodo avvia un'operazione di invio di un pacchetto UDP al gruppo multicast unito.

Il client deve aver completato un join al gruppo multicast. L'indirizzo di destinazione specificato nel remoteEndPoint parametro deve avere già inviato un pacchetto multicast a questo ricevitore. Alcuni protocolli usano queste informazioni per passare lungo il controllo del flusso, la qualità delle statistiche del servizio o i messaggi di ripristino.

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

La trasmissione è consentita solo se l'indirizzo specificato nel remoteEndPoint parametro ha già inviato un pacchetto multicast a questo ricevitore. Se l'accesso al client non è consentito, viene generata un'eccezione SocketException con AccessDenied.

Se la porta di destinazione specificata nel remoteEndPoint parametro è minore di 1.024, viene generata un'eccezione SocketException con AccessDenied.

È 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