NetworkStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia una lettura asincrona da NetworkStream.
public:
override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);public:
override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int size, AsyncCallback ^ callback, System::Object ^ state);public override IAsyncResult BeginRead(byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);public override IAsyncResult BeginRead(byte[] buffer, int offset, int size, AsyncCallback? callback, object? state);public override IAsyncResult BeginRead(byte[] buffer, int offset, int size, AsyncCallback callback, object state);override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResultoverride this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultPublic Overrides Function BeginRead (buffer As Byte(), offset As Integer, size As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParametri
- buffer
- Byte[]
Matrice di tipo Byte che rappresenta la posizione in memoria per archiviare i dati letti da NetworkStream.
- offset
- Int32
Posizione in buffer in cui iniziare a archiviare i dati.
- countsize
- Int32
Numero di byte da leggere da NetworkStream.
- callback
- AsyncCallback
Delegato AsyncCallback che viene eseguito al BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) termine.
- state
- Object
Oggetto che contiene eventuali dati aggiuntivi definiti dall'utente.
Restituisce
Oggetto IAsyncResult che rappresenta la chiamata asincrona.
Eccezioni
Il buffer parametro è null.
Il offset parametro è minore di 0.
oppure
Il offset parametro è maggiore della lunghezza del buffer parametro.
oppure
è size minore di 0.
oppure
size è maggiore della lunghezza di buffer meno il valore del offset parametro.
L'oggetto sottostante Socket è chiuso.
oppure
Si è verificato un errore durante la lettura dalla rete.
oppure
Si è verificato un errore durante l'accesso al socket.
L'oggetto NetworkStream è chiuso.
Commenti
Importante
Si tratta di un'API di compatibilità. Non è consigliabile usare i metodi APM (Begin/End) per il nuovo sviluppo. Usare invece gli equivalenti basati su attività.
È possibile passare un callback che implementa AsyncCallback a BeginRead 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 BeginRead. 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 BeginRead metodo .
L'operazione BeginRead deve essere completata chiamando il EndRead metodo . In genere, il metodo viene richiamato dal delegato fornito AsyncCallback . EndRead blocca il thread chiamante fino al completamento dell'operazione.
L'operazione legge la quantità di dati disponibile, fino al numero di byte specificato dal count parametro .
Annotazioni
Se si riceve un oggetto IOException, controllare la InnerException proprietà per determinare se è stata causata da un oggetto SocketException. In tal caso, utilizzare la ErrorCode proprietà per ottenere il codice di errore specifico.
Le operazioni di lettura e scrittura possono essere eseguite simultaneamente in un'istanza della NetworkStream classe senza la necessità di sincronizzazione. Finché è presente un thread univoco per le operazioni di scrittura e un thread univoco per le operazioni di lettura, non ci saranno interferenze incrociate tra thread di lettura e scrittura e non è necessaria alcuna sincronizzazione.
