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

定義

命名空間:

System.IO.Compression

組件:

System.IO.Compression.dll

來源:

GZipStream.cs

開始非同步的讀取作業。 (請考慮使用 ReadAsync(Byte[], Int32, Int32) 方法替代。)

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

參數

buffer

Byte[]

要讀入資料的位元組陣列。

offset

Int32

要開始從數據流讀取數據的位元移。

count

Int32

要讀取的最大位元組數。

asyncCallback

AsyncCallback

選擇性的非同步回呼，在讀取作業完成時呼叫。

asyncState

Object

使用者所提供的物件，其可以從其他要求中區分出這個特定非同步讀取的要求。

傳回

IAsyncResult

物件，表示可能還在暫止中的非同步讀取作業。

例外狀況

IOException

嘗試非同步讀取的方法超越資料流結尾，或發生了磁碟錯誤。

ArgumentException

一或多個引數無效。

ObjectDisposedException

關閉資料流後呼叫了方法。

NotSupportedException

目前的 GZipStream 實作不支援讀取作業。

InvalidOperationException

無法執行讀取作業，因為資料流已關閉。

備註

重要

從 .NET 6 開始，這個方法可能不會讀取所要求的位元元組數目。 如需詳細資訊，請參閱 DeflateStream、GZipStream 和 CryptoStream 中的部分和零位元組讀取。

從 .NET Framework 4.5 開始，您可以使用 方法來執行異步讀取作業Stream.ReadAsync。 此方法 BeginRead 仍可在目前的版本中使用，以支援舊版程式代碼;不過，您可以使用新的異步方法，更輕鬆地實作異步 I/O 作業。 如需詳細資訊，請參閱 異步檔案 I/O。

將傳 IAsyncResult 回值傳遞至 EndRead 數據流的 方法，以判斷已讀取的位元元組數目，以及釋放用於讀取的操作系統資源。 您可以使用呼叫 BeginRead 的相同程式代碼，或在傳遞至 BeginRead的回呼中執行此動作。

發出異步讀取或寫入時，數據流中的目前位置會更新，而不是在 I/O 作業完成時更新。

多個同時異步要求會轉譯要求完成順序不確定。

CanRead使用屬性來判斷目前的 GZipStream 物件是否支援讀取。

如果數據流已關閉，或您傳遞無效的自變數，則會立即從 BeginRead擲回例外狀況。 異步讀取要求期間發生的錯誤，例如 I/O 要求期間的磁碟失敗，會在線程集區線程上發生，並在呼叫 EndRead時擲回例外狀況。