RandomAccess.Read 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)	以给定偏移量从给定文件中读取字节序列。
Read(SafeFileHandle, Span<Byte>, Int64)	以给定偏移量从给定文件中读取字节序列。

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

Source:

RandomAccess.cs

以给定偏移量从给定文件中读取字节序列。

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 -> int64

Public 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

要从中读取的文件位置。

返回

Int64

读取到缓冲区的字节总数。 如果多个字节当前不可用，则这可以小于缓冲区中分配的字节数;如果已到达文件的末尾，则为零 (0) 。

例外

ArgumentNullException

handle 或 buffers 为 null。

ArgumentException

handle 无效。

ObjectDisposedException

文件关闭。

NotSupportedException

文件不支持查找 (管道或套接字) 。

ArgumentOutOfRangeException

fileOffset 为负数。

UnauthorizedAccessException

handle 未打开以供阅读。

IOException

出现 I/O 错误。

注解

文件的位置不是高级的。

Read(SafeFileHandle, Span<Byte>, Int64)

Source:

RandomAccess.cs

以给定偏移量从给定文件中读取字节序列。

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 -> int

Public Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As Integer

参数

handle

SafeFileHandle

文件句柄。

buffer

Span<Byte>

内存的区域。 此方法返回时，此区域的内容将替换为从文件读取的字节。

fileOffset

Int64

要从中读取的文件位置。

返回

Int32

读入缓冲区中的总字节数。 如果多个字节当前不可用，则这可以小于缓冲区中分配的字节数;如果已到达文件的末尾，则为零 (0) 。

例外

ArgumentNullException

handle 为 null。

ArgumentException

handle 无效。

ObjectDisposedException

文件关闭。

NotSupportedException

文件不支持查找 (管道或套接字) 。

ArgumentOutOfRangeException

fileOffset 为负数。

UnauthorizedAccessException

handle 未打开以供阅读。

IOException

出现 I/O 错误。

注解

文件的位置不是高级的。