Socket.ReceiveAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

ReceiveAsync(ArraySegment<Byte>)	Riceve i dati da un socket connesso.
ReceiveAsync(IList<ArraySegment<Byte>>)	Riceve i dati da un socket connesso.
ReceiveAsync(SocketAsyncEventArgs)	Avvia una richiesta asincrona per ricevere dati da un oggetto Socket connesso.
ReceiveAsync(ArraySegment<Byte>, SocketFlags)	Riceve i dati da un socket connesso.
ReceiveAsync(IList<ArraySegment<Byte>>, SocketFlags)	Riceve i dati da un socket connesso.
ReceiveAsync(Memory<Byte>, CancellationToken)	Riceve i dati da un socket connesso.
ReceiveAsync(Memory<Byte>, SocketFlags, CancellationToken)	Riceve i dati da un socket connesso.

ReceiveAsync(ArraySegment<Byte>)

Source:

Socket.Tasks.cs

Riceve i dati da un socket connesso.

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

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

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

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

Parametri

buffer

ArraySegment<Byte>

Buffer per i dati ricevuti.

Restituisce

Task<Int32>

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

Eccezioni

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

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

ReceiveAsync(IList<ArraySegment<Byte>>)

Source:

Socket.Tasks.cs

Riceve i dati da un socket connesso.

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

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

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

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

Parametri

buffers

IList<ArraySegment<Byte>>

Elenco di buffer per i dati ricevuti.

Restituisce

Task<Int32>

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

Eccezioni

ArgumentNullException

Il parametro buffers è null.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

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

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 Receive(IList<ArraySegment<Byte>>).

ReceiveAsync(SocketAsyncEventArgs)

Source:

Socket.cs

Avvia una richiesta asincrona per ricevere dati da un oggetto Socket connesso.

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

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

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

Public Function ReceiveAsync (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

Un argomento non è valido. 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

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

Commenti

Il ReceiveAsync metodo viene usato nei socket connessi o nei socket senza connessione associati e viene usato per leggere i dati in ingresso. L'indirizzo locale del socket deve essere noto.

Per i socket senza connessione associati, questa funzione limita gli indirizzi da cui vengono accettati i messaggi ricevuti. La funzione restituisce solo messaggi dall'indirizzo remoto specificato nella connessione. I messaggi provenienti da altri indirizzi vengono eliminati automaticamente.

La SocketAsyncEventArgs.SocketFlags proprietà sul parametro fornisce al e provider di servizi Window Sockets informazioni aggiuntive sulla richiesta di lettura. Per altre informazioni su come usare questo parametro, vedere System.Net.Sockets.SocketFlags.

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

Per i socket in stile flusso di byte, i dati in ingresso vengono inseriti nel buffer fino a quando il buffer non viene riempito, la connessione viene chiusa o i dati memorizzati nel buffer internamente vengono esauriti.

Per i socket orientati ai messaggi, un messaggio in ingresso viene inserito nel buffer fino alle dimensioni totali del buffer associato al e parametro . Se il messaggio è maggiore del buffer, il buffer viene riempito con la prima parte del messaggio.

Per i socket orientati alla connessione, il ReceiveAsync metodo può indicare la terminazione normale del circuito virtuale in uno dei due modi che dipendono dal fatto che il socket sia un flusso di byte o orientato ai messaggi. Per i flussi di byte, zero byte letti indica una chiusura normale e che non verranno mai letti altri byte. Per i socket orientati ai messaggi, in cui un messaggio a byte zero è spesso consentito, viene usato un SocketException oggetto con il SocketAsyncEventArgs.SocketError valore impostato sul codice di errore nativo WSAEDISCON (10101) per indicare la chiusura normale. In ogni caso, un SocketException oggetto con impostato sul SocketAsyncEventArgs.SocketError codice di errore WSAECONNRESET nativo (10054) indica che si è verificata una chiusura interrotta.

Vedi anche

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

ReceiveAsync(ArraySegment<Byte>, SocketFlags)

Source:

Socket.Tasks.cs

Riceve i dati da un socket connesso.

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

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

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

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

Parametri

buffer

ArraySegment<Byte>

Buffer per i dati ricevuti.

socketFlags

SocketFlags

Combinazione bit per bit dei valori SocketFlags che verranno usati durante la ricezione dei dati.

Restituisce

Task<Int32>

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

Eccezioni

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

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

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

Source:

Socket.Tasks.cs

Riceve i dati da un socket connesso.

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

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

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

Public Function ReceiveAsync (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 ricevuti.

socketFlags

SocketFlags

Combinazione bit per bit dei valori SocketFlags che verranno usati durante la ricezione dei dati.

Restituisce

Task<Int32>

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

Eccezioni

ArgumentNullException

Il parametro buffers è null.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

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

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

ReceiveAsync(Memory<Byte>, CancellationToken)

Source:

Socket.Tasks.cs

Riceve i dati da un socket connesso.

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

member this.ReceiveAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

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

Parametri

buffer

Memory<Byte>

Buffer per i dati ricevuti.

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

Eccezioni

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

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

OperationCanceledException

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

ReceiveAsync(Memory<Byte>, SocketFlags, CancellationToken)

Source:

Socket.Tasks.cs

Riceve i dati da un socket connesso.

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

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

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

Parametri

buffer

Memory<Byte>

Buffer per i dati ricevuti.

socketFlags

SocketFlags

Combinazione bit per bit dei valori SocketFlags che verranno usati durante la ricezione 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 ricevuti.

Eccezioni

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SocketException

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

OperationCanceledException

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