Metodo Socket.ReceiveAsync

Il metodo ReceiveAsync viene utilizzato sui socket connessi o sui socket privi di connessione associati e viene utilizzato per leggere i dati in ingresso. L'indirizzo locale del socket deve essere noto.

Per i socket privi di connessione associati, questa funzione limita gli indirizzi da cui vengono accettati i messaggi ricevuti. La funzione restituisce solo i messaggi dall'indirizzo remoto specificato nella connessione. I messaggi provenienti da altri indirizzi vengono ignorati in modo invisibile all'utente.

La proprietà SocketAsyncEventArgs.SocketFlags sul parametro e fornisce al provider di servizi di Windows Sockets informazioni aggiuntive sulla richiesta di lettura. Per ulteriori informazioni sull'utilizzo di questo parametro, vedere System.Net.Sockets.SocketFlags.

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

• SocketAsyncEventArgs.Buffer o SocketAsyncEventArgs.BufferList

• SocketAsyncEventArgs.Count se SocketAsyncEventArgs.Buffer è impostato

• SocketAsyncEventArgs.Offset se SocketAsyncEventArgs.Buffer è impostato

• SocketAsyncEventArgs.Completed

Il chiamante può impostare la proprietà SocketAsyncEventArgs.UserToken su qualsiasi oggetto di stato utente desiderato prima di chiamare il metodo ReceiveAsync, in modo che le informazioni possano essere recuperate 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, ad esempio i membri.

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

Per i socket orientati ai messaggi, un messaggio in arrivo viene inserito nel buffer fino alla dimensione totale del buffer associato al parametro e. Se il messaggio è più grande del buffer, il buffer viene riempito con la prima parte del messaggio.

Per i socket orientati alla connessione, il metodo ReceiveAsync può indicare la chiusura normale del circuito virtuale in uno di due modi che dipendono dal fatto che il socket sia un flusso di byte o orientato ai messaggi. Per i flussi di byte, la lettura di zero byte indica che la chiusura è avvenuta normalmente e che non verranno più letti altri byte. Per i socket orientati ai messaggi, dove è spesso consentito un messaggio a zero byte, viene utilizzata un'eccezione SocketException con l'oggetto SocketAsyncEventArgs.SocketError impostato sul codice di errore Winsock WSAEDISCON nativo (10101) per indicare la chiusura normale. In qualsiasi caso, un'eccezione SocketException con l'oggetto SocketAsyncEventArgs.SocketError impostato sul codice di errore Winsock WSAECONNRESET nativo (10054) indica che si è verificata una chiusura anomala.

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti