RandomAccess 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供基於偏移量的 API，以執行緒安全的方式讀寫檔案。
public ref class RandomAccess abstract sealedpublic static class RandomAccesstype RandomAccess = classPublic Class RandomAccess- 繼承
-
RandomAccess
備註
在 .NET 10 及更早版本中，讀寫方法僅支援支援尋址的檔案。
從 .NET 11 開始，讀寫方法也支援不可尋道的句柄，如管線、套接字和字元裝置。 對於這些 handle， fileOffset 參數會被忽略，但其值仍必須為非負。
對於支援尋址的檔案，讀寫操作會使用指定的偏移量，但不會推進檔案位置。 GetLength 並且 SetLength 要求一個在所有版本中都能支援尋找的帳號。
方法
| 名稱 | Description |
|---|---|
| FlushToDisk(SafeFileHandle) |
將該檔案的作業系統緩衝區清空到磁碟。 |
| GetLength(SafeFileHandle) |
取得檔案長度（位元組）。 |
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
從指定偏移量讀取給定檔案的一串位元組。 |
| Read(SafeFileHandle, Span<Byte>, Int64) |
從指定偏移量讀取給定檔案的一串位元組。 |
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
從指定偏移量讀取給定檔案的一串位元組。 |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
從指定偏移量讀取給定檔案的一串位元組。 |
| SetLength(SafeFileHandle, Int64) |
將檔案長度設定為給定值。 |
| Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64) |
從給定緩衝區寫入一串位元組到指定偏移的檔案。 |
| Write(SafeFileHandle, ReadOnlySpan<Byte>, Int64) |
從指定緩衝區寫入一串位元組到指定偏移量的檔案。 |
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
從給定緩衝區寫入一串位元組到指定偏移的檔案。 |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
從指定緩衝區寫入一串位元組到指定偏移量的檔案。 |
