RandomAccess 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供基于偏移的 API,以线程安全的方式读取和写入文件。
public ref class RandomAccess abstract sealed
public static class RandomAccess
type RandomAccess = class
Public Class RandomAccess
- 继承
-
RandomAccess
注解
在 .NET 10 及更早版本中,读写方法仅支持支持查找的文件。
从 .NET 11 开始,读取和写入方法还支持不可查找的句柄,例如管道、套接字和字符设备。 对于这些句柄, fileOffset 参数将被忽略,但其值仍必须为非负值。
对于支持查找、读取和写入操作的文件,请使用指定的偏移量,而不会提升文件位置。 GetLength 并且 SetLength 需要支持在所有版本中查找的句柄。
方法
| 名称 | 说明 |
|---|---|
| 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) |
将给定缓冲区中的字节序列写入给定偏移量处的给定文件。 |