GZipStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metodo

Definizione

Spazio dei nomi:

System.IO.Compression

Assembly:

netstandard.dll, System.IO.Compression.dll

Origine:

GZipStream.cs

Avvia un'operazione di lettura asincrona. Prendere invece in considerazione l'uso del ReadAsync(Byte[], Int32, Int32) metodo .

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public override IAsyncResult BeginRead(byte[] buffer, int offset, int count, AsyncCallback? asyncCallback, object? asyncState);

override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametri

buffer

Byte[]

Matrice di byte in cui leggere i dati.

offset

Int32

Offset di byte in corrispondenza del quale iniziare la lettura dei dati dal flusso.

count

Int32

Numero massimo di byte da leggere.

asyncCallback

AsyncCallback

Callback asincrono facoltativo da chiamare al termine dell'operazione di lettura.

asyncState

Object

Oggetto fornito dall'utente che distingue questa particolare richiesta di lettura asincrona da altre richieste.

Restituisce

IAsyncResult

Oggetto che rappresenta l'operazione di lettura asincrona, che potrebbe essere ancora in sospeso.

Eccezioni

IOException

Il metodo ha tentato di leggere in modo asincrono oltre la fine del flusso o si è verificato un errore del disco.

ArgumentException

Uno o più argomenti non sono validi.

ObjectDisposedException

I metodi sono stati chiamati dopo la chiusura del flusso.

NotSupportedException

L'implementazione corrente GZipStream non supporta l'operazione di lettura.

InvalidOperationException

Impossibile eseguire un'operazione di lettura perché il flusso è chiuso.

Commenti

Importante

A partire da .NET 6, questo metodo potrebbe non leggere il numero di byte richiesto. Per altre informazioni, vedere Letture di byte parziali e zero in DeflateStream, GZipStream e CryptoStream.

A partire da .NET Framework 4.5, è possibile eseguire operazioni di lettura asincrone usando il Stream.ReadAsync metodo . Il BeginRead metodo è ancora disponibile nelle versioni correnti per supportare il codice legacy. Tuttavia, è possibile implementare più facilmente operazioni di I/O asincrone usando i nuovi metodi asincroni. Per altre informazioni, vedere I/O di file asincrono.

Passare il IAsyncResult valore restituito al EndRead metodo del flusso per determinare il numero di byte letti e rilasciare le risorse del sistema operativo usate per la lettura. A tale scopo, è possibile usare lo stesso codice chiamato BeginRead o in un callback passato a BeginRead.

La posizione corrente nel flusso viene aggiornata quando viene eseguita la lettura o la scrittura asincrona, non al termine dell'operazione di I/O.

Più richieste asincrone simultanee rendono incerto l'ordine di completamento della richiesta.

Utilizzare la CanRead proprietà per determinare se l'oggetto corrente GZipStream supporta la lettura.

Se un flusso viene chiuso o si passa un argomento non valido, le eccezioni vengono generate immediatamente da BeginRead. Gli errori che si verificano durante una richiesta di lettura asincrona, ad esempio un errore del disco durante la richiesta di I/O, si verificano nel thread del pool di thread e generano eccezioni quando si chiama EndRead.