UdpClient.SendAsync Metodo

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

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

Restituisce

Restituisce Task<TResult>.

Eccezioni

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

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

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

Restituisce

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

Eccezioni

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

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

Restituisce

Restituisce Task<TResult>.

Eccezioni

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.

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

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

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

Restituisce

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

Eccezioni

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

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

Restituisce

Restituisce Task<TResult>.

Eccezioni

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.

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

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

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

Restituisce

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

Eccezioni