IsolatedStorageFileStream.Read 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
Read(Byte[], Int32, Int32) |
將位元組從目前緩衝的 IsolatedStorageFileStream 物件複製到位元組陣列。 |
Read(Span<Byte>) |
將位元組從目前緩衝的 IsolatedStorageFileStream 物件複製到位元組範圍。 |
Read(Byte[], Int32, Int32)
將位元組從目前緩衝的 IsolatedStorageFileStream 物件複製到位元組陣列。
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
開始寫入緩衝區的位移。
- count
- Int32
要讀取的最大位元組數。
傳回
讀取到 buffer
中的位元組總數。 如果目前無法提供那麼多的位元組數目,則這個數目可能小於所要求的位元組數,或如果已經到達資料流結尾,則為零。
備註
參數buffer
可以是 類別的Buffer實例,或下列其中一種類型的陣列:Byte、SByte、 Int32UInt32Int16Int64UInt64UInt16CharSingle或 。Double
如果讀取作業成功,數據流的目前位置會由讀取的位元組數目進階。 如果發生例外狀況,數據流的目前位置不會變更。
不論參數的實際類型為何,方法 Read 都會將 buffer
參數視為位元組區塊。 同樣地, offset
和 count
參數一律以位元組指定。 對於buffer
位元組陣列以外的參數,這表示元素索引或元素數目必須乘以位元組為單位的專案大小,才能為 或count
形成正確的值offset
。
Read只有在到達數據流結尾時,方法才會傳回零。 在所有其他情況下, Read 一律會先從數據流讀取至少一個字節,然後再傳回。 如果在呼叫 Read時無法從 IsolatedStorageFileStream 物件取得任何數據,方法將會封鎖,直到可以傳回至少一個字節的數據為止。
適用於
Read(Span<Byte>)
將位元組從目前緩衝的 IsolatedStorageFileStream 物件複製到位元組範圍。
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
中的位元組總數。 如果目前無法提供那麼多的位元組數目,則這個數目可能小於所要求的位元組數,或如果已經到達資料流結尾,則為零。