BrotliStream.Read 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Read(Span<Byte>) |
從目前 Brotli 串流讀取一串位元組到位元組區間,並依讀取位元組數推進 Brotli 串流中的位置。 |
| Read(Byte[], Int32, Int32) |
將若干解壓縮的位元組讀取到指定的位元組陣列中。 |
Read(Span<Byte>)
從目前 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
參數
傳回
讀取到緩衝區的總位元組數。 如果目前沒有該位元組可用,這可能少於緩衝區中分配的位元組數;若已到達串流結束,則為零(0)。
備註
利用該 CanRead 屬性判斷目前實例是否支援讀取。 使用該 System.IO.Compression.BrotliStream.ReadAsync 方法非同步讀取目前串流。
此方法讀取最大值為 'buffer.從當前串流中取 length' 位元組,並將它們儲存在 buffer。 Brotli 串流中的當前位置會依讀取的位元組數前進;但若發生例外,目前在 Brotli 溪流中的位置保持不變。 此方法會阻塞,直到至少能讀取一個位元組資料,若無資料可用。 「讀取」僅在資料流中沒有更多資料且預期不會有更多資料時回傳 0(例如封閉套接字或檔案結束)。 即使串流尚未到達終點,此方法仍可自由回傳比請求的位元組少。
用於 BinaryReader 讀取原始資料型態。
適用於
Read(Byte[], Int32, Int32)
將若干解壓縮的位元組讀取到指定的位元組陣列中。
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
可讀取的最大解壓縮位元組數。
傳回
解壓縮到位元組陣列中的位元組數量。 若串流已到達末端,則回傳為零或讀取的位元組數。
例外狀況
buffer 是 null。
該 CompressionMode 值是 Compress 物件建立時,或是該串流上已有活躍的非同步操作。
offset 或 count 小於零。
buffer長度減去指標起點小count於 。
資料格式無效。
底層串流為空或封閉。