Socket.SendAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	Invia dati su un socket connesso.
SendAsync(IList<ArraySegment<Byte>>, SocketFlags)	Invia dati su un socket connesso.
SendAsync(ArraySegment<Byte>, SocketFlags)	Invia dati su un socket connesso.
SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)	Invia dati su un socket connesso.
SendAsync(IList<ArraySegment<Byte>>)	Invia dati su un socket connesso.
SendAsync(ArraySegment<Byte>)	Invia dati su un socket connesso.
SendAsync(SocketAsyncEventArgs)	Invia i dati in modo asincrono a un oggetto Socket connesso.

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:

Socket.Tasks.cs

Invia dati su un socket connesso.

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

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

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

Parametri

buffer

ReadOnlyMemory<Byte>

Buffer per i dati da inviare.

cancellationToken

CancellationToken

Token di annullamento che può essere utilizzato per annullare l'operazione asincrona.

Restituisce

ValueTask<Int32>

Attività asincrona che viene completata con il numero di byte inviati.

Eccezioni

OperationCanceledException

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

SendAsync(IList<ArraySegment<Byte>>, SocketFlags)

Source:

Socket.Tasks.cs

Invia dati su un socket connesso.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Task(Of Integer)

Parametri

buffers

IList<ArraySegment<Byte>>

Elenco di buffer per i dati da inviare.

socketFlags

SocketFlags

Combinazione bit per bit dei valori SocketFlags che verranno usati durante l'invio dei dati.

Restituisce

Task<Int32>

Attività asincrona che viene completata con il numero di byte inviati.

Eccezioni

ArgumentNullException

buffers è null.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Commenti

Questo metodo archivia nell'attività 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(IList<ArraySegment<Byte>>, SocketFlags).

SendAsync(ArraySegment<Byte>, SocketFlags)

Source:

Socket.Tasks.cs

Invia dati su un socket connesso.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : ArraySegment<byte> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags) As Task(Of Integer)

Parametri

buffer

ArraySegment<Byte>

Buffer per i dati da inviare.

socketFlags

SocketFlags

Combinazione bit per bit dei valori SocketFlags che verranno usati durante l'invio dei dati.

Restituisce

Task<Int32>

Attività asincrona che viene completata con il numero di byte inviati.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)

Source:

Socket.Tasks.cs

Invia dati su un socket connesso.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Threading.CancellationToken cancellationToken = default);

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

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

Parametri

buffer

ReadOnlyMemory<Byte>

Buffer per i dati da inviare.

socketFlags

SocketFlags

Combinazione bit per bit dei valori SocketFlags che verranno usati durante l'invio dei dati.

cancellationToken

CancellationToken

Token di annullamento che può essere utilizzato per annullare l'operazione asincrona.

Restituisce

ValueTask<Int32>

Attività asincrona che viene completata con il numero di byte inviati.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

OperationCanceledException

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

SendAsync(IList<ArraySegment<Byte>>)

Source:

Socket.Tasks.cs

Invia dati su un socket connesso.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte))) As Task(Of Integer)

Parametri

buffers

IList<ArraySegment<Byte>>

Elenco di buffer per i dati da inviare.

Restituisce

Task<Int32>

Attività asincrona che viene completata con il numero di byte inviati.

Eccezioni

ArgumentNullException

buffers è null.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Commenti

Questo metodo archivia nell'attività 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(IList<ArraySegment<Byte>>).

SendAsync(ArraySegment<Byte>)

Source:

Socket.Tasks.cs

Invia dati su un socket connesso.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer);

member this.SendAsync : ArraySegment<byte> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte)) As Task(Of Integer)

Parametri

buffer

ArraySegment<Byte>

Buffer per i dati da inviare.

Restituisce

Task<Int32>

Attività asincrona che viene completata con il numero di byte inviati.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SendAsync(SocketAsyncEventArgs)

Source:

Socket.cs

Invia i dati in modo asincrono a un oggetto Socket connesso.

public:
 bool SendAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool SendAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.SendAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function SendAsync (e As SocketAsyncEventArgs) As Boolean

Parametri

e

SocketAsyncEventArgs

Oggetto SocketAsyncEventArgs da utilizzare per questa operazione socket asincrona.

Restituisce

Boolean

true se l'operazione di I/O è in sospeso. Al completamento dell'operazione verrà generato l'evento Completed sul parametro e.

false se l'operazione di I/O è stata completata in modo sincrono. In questo caso, l'evento Completed sul parametro e non verrà generato e l'oggetto e passato come parametro potrebbe essere esaminato immediatamente dopo che la chiamata al metodo è stata restituita per recuperare il risultato dell'operazione.

Eccezioni

ArgumentException

Le proprietà Buffer o BufferList sul parametro e devono fare riferimento a buffer validi. È possibile impostare una di queste due proprietà, ma non entrambe contemporaneamente.

InvalidOperationException

Era già in corso un'operazione di socket che utilizza l'oggetto SocketAsyncEventArgs specificato nel parametro e.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

L'oggetto Socket non è ancora connesso o non è stato ottenuto tramite un metodo Accept(), AcceptAsync(SocketAsyncEventArgs) o BeginAccept.

Commenti

Il SendAsync metodo viene usato per scrivere dati in uscita da uno o più buffer in un socket orientato alla connessione. Questo metodo può essere usato anche nei socket senza connessione che hanno specificato un host remoto in un'operazione di connessione.

Il SendAsync metodo avvia un'operazione di invio asincrona all'host remoto stabilito nel Acceptmetodo , AcceptAsync, BeginAcceptBeginConnect, Connect, o ConnectAsync .

Per chiamare correttamente questo metodo, sono necessari gli eventi e le proprietà seguenti sull'oggetto System.Net.Sockets.SocketAsyncEventArgs :

• SocketAsyncEventArgs.Buffer o SocketAsyncEventArgs.BufferList

• SocketAsyncEventArgs.Count se SocketAsyncEventArgs.Buffer è impostato

• SocketAsyncEventArgs.Offset se SocketAsyncEventArgs.Buffer è impostato

• SocketAsyncEventArgs.Completed

Il chiamante può impostare la SocketAsyncEventArgs.UserToken proprietà su qualsiasi oggetto stato utente desiderato prima di chiamare il SendAsync metodo, in modo che le informazioni siano recuperabili nel metodo di callback. Se il callback richiede più informazioni di un singolo oggetto, è possibile creare una classe piccola per contenere le altre informazioni sullo stato necessarie come membri.

Il SendAsync metodo genererà un'eccezione se non si chiama Acceptprima , , BeginAcceptAcceptAsyncBeginConnect, Connecto .ConnectAsync

La chiamata al SendAsync metodo consente di inviare dati all'interno di un thread di esecuzione separato.

Per i socket orientati ai messaggi, non superare le dimensioni massime del messaggio del provider di servizi Windows Sockets sottostante. Se i dati sono troppo lunghi per passare in modo atomico tramite il provider di servizi sottostante, non vengono trasmessi dati e il SendAsync metodo genera un SocketException oggetto con l'oggetto SocketAsyncEventArgs.SocketError impostato sul codice di errore WSAEMSGSIZE nativo winsock (10040).

Si noti che il completamento corretto del SendAsync metodo non indica che i dati sono stati recapitati correttamente.

Vedi anche

• SocketAsyncEventArgs
• Buffer
• BufferList
• Completed
• Count
• Offset
• UserToken