Condividi tramite


UdpClient.SendAsync Metodo

Definizione

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
Origine:
UDPClient.cs
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

Restituisce Task<TResult>.

Eccezioni

dgram è null.

UdpClient ha già stabilito un host remoto predefinito.

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).

Si applica a

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Origine:
UDPClient.cs
Origine:
UDPClient.cs
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

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

Eccezioni

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

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

Si applica a

SendAsync(Byte[], Int32, IPEndPoint)

Origine:
UDPClient.cs
Origine:
UDPClient.cs
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);
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

Restituisce Task<TResult>.

Eccezioni

dgram è null.

UdpClient ha già stabilito un host remoto predefinito.

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).

Si applica a

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

Origine:
UDPClient.cs
Origine:
UDPClient.cs
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

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

Eccezioni

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

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

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

Si applica a

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

Origine:
UDPClient.cs
Origine:
UDPClient.cs
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);
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

Restituisce Task<TResult>.

Eccezioni

dgram è null.

UdpClient ha già stabilito un host remoto predefinito.

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).

Si applica a

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

Origine:
UDPClient.cs
Origine:
UDPClient.cs
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

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

Eccezioni

UdpClient ha già stabilito un host remoto predefinito.

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

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

Si applica a