RandomAccess.Read 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
從指定偏移量讀取給定檔案的一串位元組。 |
| Read(SafeFileHandle, Span<Byte>, Int64) |
從指定偏移量讀取給定檔案的一串位元組。 |
Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)
從指定偏移量讀取給定檔案的一串位元組。
public:
static long Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<Memory<System::Byte>> ^ buffers, long fileOffset);public static long Read(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset);static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 -> int64Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As Long參數
- handle
- SafeFileHandle
檔句柄。
- buffers
- IReadOnlyList<Memory<Byte>>
一份記憶體緩衝區清單。 當此方法回傳時，緩衝區的內容會被從檔案讀取的位元組取代。
- fileOffset
- Int64
讀取檔案的位置。
傳回
讀取到緩衝區的總位元組數。 若緩衝區目前沒有該位元組，則可少於該位元組數;若檔案已到達末尾，則為零（0）。
例外狀況
handle 或 buffers 為 null。
handle 無效。
檔案已結案。
該檔案不支援尋址（管道或套接字）。
fileOffset 為負數。
handle 未開放閱讀。
發生 I/O 錯誤。
備註
檔案位置不前。
適用於
Read(SafeFileHandle, Span<Byte>, Int64)
從指定偏移量讀取給定檔案的一串位元組。
public:
static int Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, Span<System::Byte> buffer, long fileOffset);public static int Read(Microsoft.Win32.SafeHandles.SafeFileHandle handle, Span<byte> buffer, long fileOffset);static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * Span<byte> * int64 -> intPublic Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As Integer參數
- handle
- SafeFileHandle
檔句柄。
- fileOffset
- Int64
讀取檔案的位置。
傳回
讀取到緩衝區的總位元組數。 如果目前沒有那麼多位元組可用，這可能少於緩衝區中分配的位元組數;若檔案已到達尾位元組，則可能為零（0）。
例外狀況
handle 是 null。
handle 無效。
檔案已結案。
該檔案不支援尋址（管道或套接字）。
fileOffset 為負數。
handle 未開放閱讀。
發生 I/O 錯誤。
備註
檔案位置不前。
