Socket.BeginReceiveMessageFrom Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

netstandard.dll, System.Net.Sockets.dll

Origine:

Socket.cs

Inizia a ricevere in modo asincrono il numero specificato di byte di dati nella posizione specificata del buffer di dati, usando l'oggetto specificato SocketFlagse archivia l'endpoint e le informazioni sui pacchetti.

public:
 IAsyncResult ^ BeginReceiveMessageFrom(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ % remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceiveMessageFrom(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

member this.BeginReceiveMessageFrom : byte[] * int * int * System.Net.Sockets.SocketFlags * EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveMessageFrom (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parametri

buffer

Byte[]

Matrice di tipo Byte che rappresenta il percorso di archiviazione per i dati ricevuti.

offset

Int32

Posizione in base zero nel parametro in corrispondenza del buffer quale archiviare i dati.

size

Int32

Numero di byte da ricevere.

socketFlags

SocketFlags

Combinazione bit per bit dei SocketFlags valori.

remoteEP

EndPoint

Riferimento a uno EndPoint dello stesso tipo dell'endpoint dell'host remoto da aggiornare alla ricezione sincrona.

callback

AsyncCallback

Delegato AsyncCallback .

state

Object

Oggetto che contiene informazioni sullo stato per questa richiesta.

Restituisce

IAsyncResult

Oggetto IAsyncResult che fa riferimento alla lettura asincrona.

Eccezioni

ArgumentNullException

buffer è null.

oppure

remoteEP è null.

SocketException

Solo .NET Framework e .NET 5 e versioni precedenti: si è verificato un errore durante il tentativo di accesso al socket.

ArgumentOutOfRangeException

offset è minore di 0.

oppure

offset è maggiore della lunghezza di buffer.

oppure

size è minore di 0.

oppure

size è maggiore della lunghezza di buffer meno il valore del offset parametro.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Commenti

Importante

Si tratta di un'API di compatibilità. Non è consigliabile usare i metodi APM (Begin* e End*) per nuovi sviluppi. Usare invece gli Taskequivalenti basati su .

È possibile passare un callback che implementa AsyncCallback a BeginReceiveMessageFrom per ricevere una notifica sul completamento dell'operazione. Si noti che se lo stack di rete sottostante completa l'operazione in modo sincrono, il callback verrà eseguito inline, durante la chiamata a BeginReceiveMessageFrom. In questo caso, la CompletedSynchronously proprietà sull'oggetto restituito verrà impostata IAsyncResult su true per indicare che il metodo è stato completato in modo sincrono. Utilizzare la AsyncState proprietà dell'oggetto IAsyncResult per ottenere l'oggetto di stato passato al BeginReceiveMessageFrom metodo .

L'operazione asincrona BeginReceiveMessageFrom deve essere completata chiamando il EndReceiveMessageFrom metodo . In genere, il metodo viene richiamato dal AsyncCallback delegato. EndReceiveMessageFrom blocca il thread chiamante fino al completamento dell'operazione.

Per annullare un oggetto in sospeso BeginReceiveMessageFrom, chiamare il Close metodo .

Questo metodo legge i dati nel buffer parametro e acquisisce l'endpoint host remoto da cui vengono inviati i dati, nonché informazioni sul pacchetto ricevuto. Per informazioni su come recuperare questo endpoint, vedere EndReceiveMessageFrom. Questo metodo è più utile se si prevede di ricevere in modo asincrono datagrammi senza connessione da un host sconosciuto o da più host.

Annotazioni

Se si riceve un oggetto SocketException, utilizzare la SocketException.ErrorCode proprietà per ottenere il codice di errore specifico.

Annotazioni

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Annotazioni

Il contesto di esecuzione ,ovvero il contesto di sicurezza, l'utente rappresentato e il contesto chiamante, viene memorizzato nella cache per i metodi asincroni Socket . Dopo il primo utilizzo di un contesto specifico (un metodo asincrono Socket specifico, un'istanza specifica Socket e un callback specifico), gli usi successivi di tale contesto vedranno un miglioramento delle prestazioni.