语言

RandomAccess 类

定义

提供基于偏移的 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)

将给定缓冲区中的字节序列写入给定偏移量处的给定文件。

适用于

另请参阅