Поделиться через


RandomAccess.Read Метод

Определение

Перегрузки

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

Считывает последовательность байтов из заданного файла с заданным смещением.

Read(SafeFileHandle, Span<Byte>, Int64)

Считывает последовательность байтов из заданного файла с заданным смещением.

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

Исходный код:
RandomAccess.cs
Исходный код:
RandomAccess.cs
Исходный код:
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

Позиция файла для чтения.

Возвращаемое значение

Общее количество байтов, считанных в буферы. Это может быть меньше, чем количество байтов, выделенных в буферах, если это количество байтов в настоящее время недоступно, или ноль (0), если достигнут конец файла.

Исключения

Параметр handle или buffers имеет значение null.

handle недопустим.

Файл закрыт.

Файл не поддерживает поиск (канал или сокет).

fileOffset является отрицательным значением.

handle не был открыт для чтения.

Ошибка ввода/вывода.

Комментарии

Положение файла не является расширенным.

Применяется к

Read(SafeFileHandle, Span<Byte>, Int64)

Исходный код:
RandomAccess.cs
Исходный код:
RandomAccess.cs
Исходный код:
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

Позиция файла для чтения.

Возвращаемое значение

Общее количество байтов, считанных в буфер. Это может быть меньше, чем количество байтов, выделенных в буфере, если это количество байтов в настоящее время недоступно, или ноль (0), если достигнут конец файла.

Исключения

handle имеет значение null.

handle недопустим.

Файл закрыт.

Файл не поддерживает поиск (канал или сокет).

fileOffset является отрицательным значением.

handle не был открыт для чтения.

Ошибка ввода/вывода.

Комментарии

Положение файла не является расширенным.

Применяется к