CryptoStream.Read(Byte[], Int32, Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從目前數據流讀取位元組序列,並依讀取的位元元組數目將數據流中的位置往前移。
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[]
位元組陣列。 從目前串流讀取最多 count 位元組並儲存在 buffer。
- offset
- Int32
從目前串流讀取資料開始儲存的位元組偏移 buffer 量。
- count
- Int32
目前串流中最大可讀取的位元組數。
傳回
讀取到緩衝區的總位元組數。 若目前沒有該數量的位元組可用,這可小於請求的位元組數;若已到達串流末端,則為零。
例外狀況
與目前CryptoStreamMode物件相關的資料CryptoStream與底層串流不符。 例如,當底 Read 層串流僅寫入時,會拋出此例外。
offset 或 count 小於零。
與count參數的offset總和比緩衝區長度還長。
備註
從 .NET 6 開始,此方法可能無法讀取所需的位元組數量。 欲了解更多資訊,請參閱 DeflateStream、GZipStream 及 CryptoStream 中的部分與零位元組讀取。