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 中的部分和零位元組讀取。