UdpClient.SendAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Invia un datagramma UDP in modo asincrono a un host remoto.

Overload

SendAsync(Byte[], Int32)	Invia un datagramma UDP in modo asincrono a un host remoto.
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	Invia un datagramma UDP in modo asincrono a un host remoto.
SendAsync(Byte[], Int32, IPEndPoint)	Invia un datagramma UDP in modo asincrono a un host remoto.
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)	Invia un datagramma UDP in modo asincrono a un host remoto.
SendAsync(Byte[], Int32, String, Int32)	Invia un datagramma UDP in modo asincrono a un host remoto.
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)	Invia un datagramma UDP in modo asincrono a un host remoto.

SendAsync(Byte[], Int32)

Origine:

UDPClient.cs

Invia un datagramma UDP in modo asincrono a un host remoto.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes);

member this.SendAsync : byte[] * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer) As Task(Of Integer)

Parametri

datagram

Byte[]

Matrice di tipo Byte che specifica il datagramma UDP da inviare, rappresentato come una matrice di byte.

bytes

Int32

Numero di byte nel datagramma.

Restituisce

Task<Int32>

Restituisce Task<TResult>.

Eccezioni

ArgumentNullException

dgram è null.

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito.

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Commenti

Questo overload invia i datagrammi all'host Connect remoto stabilito nel metodo . Se non si chiama Connect prima di chiamare questo overload, il metodo genererà un SocketExceptionoggetto . Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Se si desidera inviare datagrammi a un host remoto diverso, è necessario chiamare il metodo e specificare l'host Connect remoto desiderato. Usare uno degli altri SendAsync overload del metodo per inviare datagrammi a un indirizzo di trasmissione.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(Byte[], Int32).

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Origine:

UDPClient.cs

Invia un datagramma UDP in modo asincrono a un host remoto.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametri

datagram

ReadOnlyMemory<Byte>

Oggetto ReadOnlyMemory<T> type Byte che specifica l'oggetto UDP datagram che si intende inviare.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None (Nessuna).

Restituisce

ValueTask<Int32>

Oggetto ValueTask<TResult> che rappresenta l'operazione di invio asincrona. Il valore della proprietà Result contiene il numero di byte inviati.

Eccezioni

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

SendAsync(Byte[], Int32, IPEndPoint)

Origine:

UDPClient.cs

Invia un datagramma UDP in modo asincrono a un host remoto.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::Net::IPEndPoint ^ endPoint);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint? endPoint);

member this.SendAsync : byte[] * int * System.Net.IPEndPoint -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Task(Of Integer)

Parametri

datagram

Byte[]

Matrice di tipo Byte che specifica il datagramma UDP da inviare, rappresentato come una matrice di byte.

bytes

Int32

Numero di byte nel datagramma.

endPoint

IPEndPoint

IPEndPoint che rappresenta l'host e la porta a cui inviare il datagramma.

Restituisce

Task<Int32>

Restituisce Task<TResult>.

Eccezioni

ArgumentNullException

dgram è null.

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito.

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Commenti

Questo metodo invia datagrammi all'endpoint specificato. Prima di chiamare questo overload, è prima necessario creare un IPEndPoint oggetto usando l'indirizzo IP e il numero di porta dell'host remoto a cui verranno recapitati i datagrammi. È possibile inviare datagrammi all'indirizzo di trasmissione predefinito, 255.255.255.255, specificando SocketOptionName.Broadcast per la proprietà dell'oggetto AddressIPEndPoint. Dopo aver creato questo IPEndPointmetodo , passarlo a questo metodo come endPoint parametro.

Se si desidera inviare datagrammi a qualsiasi altro indirizzo di trasmissione, usare il metodo per ottenere l'opzione Client sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast. È anche possibile ripristinare l'uso della Socket classe.

Avviso

Non fornire un parametro a questo metodo se è già stato stabilito un endPoint host remoto con il Connect metodo . In caso contrario, questo metodo genererà un SocketExceptionoggetto . Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(Byte[], Int32, IPEndPoint).

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

Origine:

UDPClient.cs

Invia un datagramma UDP in modo asincrono a un host remoto.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Net.IPEndPoint? endPoint, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), endPoint As IPEndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametri

datagram

ReadOnlyMemory<Byte>

Oggetto ReadOnlyMemory<T> type Byte che specifica l'oggetto UDP datagram che si intende inviare.

endPoint

IPEndPoint

IPEndPoint che rappresenta l'host e la porta a cui inviare il datagramma.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None (Nessuna).

Restituisce

ValueTask<Int32>

Oggetto ValueTask<TResult> che rappresenta l'operazione di invio asincrona. Il valore della proprietà Result contiene il numero di byte inviati.

Eccezioni

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito e endPoint non nullè .

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

SendAsync(Byte[], Int32, String, Int32)

Origine:

UDPClient.cs

Invia un datagramma UDP in modo asincrono a un host remoto.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::String ^ hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string? hostname, int port);

member this.SendAsync : byte[] * int * string * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, hostname As String, port As Integer) As Task(Of Integer)

Parametri

datagram

Byte[]

Matrice di tipo Byte che specifica il datagramma UDP da inviare, rappresentato come una matrice di byte.

bytes

Int32

Numero di byte nel datagramma.

hostname

String

Nome dell'host remoto a cui si vuole inviare il datagramma.

port

Int32

Numero di porta remota con cui si vuole comunicare.

Restituisce

Task<Int32>

Restituisce Task<TResult>.

Eccezioni

ArgumentNullException

dgram è null.

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito.

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Commenti

Questo metodo invia i datagrammi ai valori specificati dai hostname parametri e port . È possibile inviare datagrammi all'indirizzo di trasmissione predefinito specificando "255.255.255.255" per il valore del hostname parametro.

Se si desidera inviare datagrammi a qualsiasi altro indirizzo di trasmissione, usare il metodo per ottenere l'opzione Client sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast. È anche possibile ripristinare l'uso della Socket classe.

Avviso

Non specificare un nome host o un numero di porta a questo metodo se è già stato stabilito un host remoto con il Connect metodo . In caso contrario, questo metodo genererà un SocketExceptionoggetto . Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Send(Byte[], Int32, String, Int32).

SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)

Origine:

UDPClient.cs

Invia un datagramma UDP in modo asincrono a un host remoto.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, string? hostname, int port, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), hostname As String, port As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametri

datagram

ReadOnlyMemory<Byte>

Oggetto ReadOnlyMemory<T> di tipo Byte che specifica il datagramma UDP che si intende inviare.

hostname

String

Nome dell'host remoto a cui si vuole inviare il datagramma.

port

Int32

Numero di porta remota con cui si vuole comunicare.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None (Nessuna).

Restituisce

ValueTask<Int32>

Oggetto ValueTask<TResult> che rappresenta l'operazione di invio asincrona. Il valore della relativa proprietà Result contiene il numero di byte inviati.

Eccezioni

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito.

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.