BrotliStream.Read 方法

定義

命名空間:

System.IO.Compression

組件:

System.IO.Compression.Brotli.dll

多載

Read(Span<Byte>)	將位元組序列從目前 Brotli 資料流讀取到位元組範圍，並依讀取的位元組數將 Brotli 資料流中位置往前移。
Read(Byte[], Int32, Int32)	將大量解壓縮的位元組讀入指定的位元組陣列。

Read(Span<Byte>)

來源:

BrotliStream.Decompress.cs

將位元組序列從目前 Brotli 資料流讀取到位元組範圍，並依讀取的位元組數將 Brotli 資料流中位置往前移。

public:
 override int Read(Span<System::Byte> buffer);

public override int Read (Span<byte> buffer);

override this.Read : Span<byte> -> int

Public Overrides Function Read (buffer As Span(Of Byte)) As Integer

參數

buffer

Span<Byte>

記憶體區域。 當這個方法傳回時，讀取自目前來源的位元組會取代此區域內容。

傳回

Int32

緩衝區所讀取的總位元組數。 如果目前無法取得足夠的位元組，則這個數目可能小於緩衝區所配置的位元組數，如果已經到達資料流末端，則為零 (0)。

備註

CanRead使用屬性來判斷目前實例是否支援讀取。 System.IO.Compression.BrotliStream.ReadAsync使用方法，以異步方式從目前的數據流讀取。

這個方法會讀取 『buffer 上限。來自目前數據流的長度位元組，並將其儲存在 buffer中。 Brotli 數據流內的目前位置會依讀取的位元組數目進階;不過，如果發生例外狀況，Brotli 數據流中的目前位置會保持不變。 此方法會封鎖，直到可以讀取至少一個字節的數據，否則不會有數據可供使用。 只有當數據流中沒有其他數據，而且不會再傳回 0，而且不會再傳回任何 (，例如關閉的套接字或檔案結尾) 。 即使尚未達到數據流結尾，方法仍可傳回比要求較少的位元組。

用於 BinaryReader 讀取基本數據類型。

Read(Byte[], Int32, Int32)

來源:

BrotliStream.Decompress.cs

將大量解壓縮的位元組讀入指定的位元組陣列。

public:
 override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);

public override int Read (byte[] buffer, int offset, int count);

override this.Read : byte[] * int * int -> int

Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

參數

buffer

Byte[]

用於儲存解壓縮位元組的陣列。

offset

Int32

要在其中放置讀取位元組之 buffer 的位元組位移。

count

Int32

要讀取的最大解壓縮位元組數。

傳回

Int32

解壓縮至位元組陣列的位元組數。 如果已達到資料流的結尾，則會傳回零或位元組數。

例外狀況

ArgumentNullException

buffer 為 null。

InvalidOperationException

當物件建立時，或此資料流上已經有作用中非同步作業時，CompressionMode 值是 Compress。

ArgumentOutOfRangeException

offset 或 count 小於零。

ArgumentException

buffer 長度減去索引起點小於 count。

InvalidDataException

資料的格式無效。

ObjectDisposedException

底層資料流為 Null 或關閉。