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

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

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

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

Int64

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

Исключения

ArgumentNullException

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

ArgumentException

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

ObjectDisposedException

Файл закрыт.

NotSupportedException

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

ArgumentOutOfRangeException

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

UnauthorizedAccessException

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

IOException

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

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

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

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

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

Int32

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