Socket.SendAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

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

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Origine:

Socket.Tasks.cs

Invia i dati in 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 l'invio dei dati.

cancellationToken

CancellationToken

Token di annullamento che può essere usato 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)

Origine:

Socket.Tasks.cs

Invia i dati in 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 dei buffer da inviare ai dati.

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à 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(IList<ArraySegment<Byte>>, SocketFlags).

SendAsync(ArraySegment<Byte>, SocketFlags)

Origine:

Socket.Tasks.cs

Invia i dati in 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 l'invio dei dati.

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)

Origine:

Socket.Tasks.cs

Invia i dati in 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 l'invio dei dati.

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

Origine:

Socket.Tasks.cs

Invia i dati in 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 dei buffer da inviare ai 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à 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(IList<ArraySegment<Byte>>).

SendAsync(ArraySegment<Byte>)

Origine:

Socket.Tasks.cs

Invia i dati in 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 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(SocketAsyncEventArgs)

Origine:

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 Acceptremoto stabilito nel metodo , BeginConnectConnectAcceptAsyncBeginAccepto .ConnectAsync

Per chiamare correttamente questo metodo, sono necessarie le proprietà e gli eventi seguenti nell'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 saranno 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 metodo genererà un'eccezione SendAsync 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 socket di Windows sottostante. Se i dati sono troppo lunghi per passare atomicamente attraverso il provider di servizi sottostanti, non vengono trasmessi dati e il SendAsync metodo genera un SocketException oggetto con il SocketAsyncEventArgs.SocketError set sul codice di errore WSAEMSGSIZE nativo (10040).

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

Vedi anche

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