RandomAccess.Read Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Перегрузки

Имя	Описание
Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)	Считывает последовательность байтов из заданного смещения.
Read(SafeFileHandle, Span<Byte>, Int64)	Считывает последовательность байтов из заданного смещения.

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

Исходный код:

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

Произошла ошибка ввода-вывода.

Комментарии

Позиция файла не расширена.

Read(SafeFileHandle, Span<Byte>, Int64)

Исходный код:

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

Произошла ошибка ввода-вывода.

Комментарии

Позиция файла не расширена.