UdpAnySourceMulticastClient.BeginSendTo 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 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 del 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 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 BeginSendTo metodo inizia un'operazione di invio di un pacchetto UDP al gruppo multicast aggiunto.

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

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

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

Se la porta di destinazione specificata nel remoteEndPoint parametro è minore di 1.024, viene generata una SocketException classe con AccessDenied.

È possibile avere un errore di socket se un'operazione di ricezione ha esito sincrono, anche se questa operazione non è comune con UDP. Se si verifica un errore socket, viene generato un SocketException oggetto . L'errore ricevuto viene specificato come membro dell'enumerazione SocketError .