RandomAccess.Read Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)	Načte posloupnost bajtů z daného souboru při daném posunu.
Read(SafeFileHandle, Span<Byte>, Int64)	Načte posloupnost bajtů z daného souboru při daném posunu.

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

Zdroj:

RandomAccess.cs

Načte posloupnost bajtů z daného souboru při daném posunu.

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

Parametry

handle

SafeFileHandle

Popisovač souboru.

buffers

IReadOnlyList<Memory<Byte>>

Seznam vyrovnávacích pamětí. Když se tato metoda vrátí, obsah vyrovnávacích pamětí jsou nahrazeny bajty načtenými ze souboru.

fileOffset

Int64

Pozice souboru, ze které se má číst.

Návraty

Int64

Celkový počet bajtů načtených do vyrovnávací paměti. To může být menší než počet bajtů přidělených ve vyrovnávací paměti, pokud tento počet bajtů není aktuálně k dispozici, nebo nula (0), pokud bylo dosaženo konce souboru.

Výjimky

ArgumentNullException

handle nebo buffers je null.

ArgumentException

Formát handle je neplatný.

ObjectDisposedException

Soubor je zavřený.

NotSupportedException

Soubor nepodporuje vyhledávání (kanál nebo soket).

ArgumentOutOfRangeException

fileOffset je negativní.

UnauthorizedAccessException

handle nebyl otevřen pro čtení.

IOException

Došlo k vstupně-výstupní chybě.

Poznámky

Umístění souboru není upřesňující.

Read(SafeFileHandle, Span<Byte>, Int64)

Zdroj:

RandomAccess.cs

Načte posloupnost bajtů z daného souboru při daném posunu.

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

Parametry

handle

SafeFileHandle

Popisovač souboru.

buffer

Span<Byte>

Oblast paměti. Když se tato metoda vrátí, obsah této oblasti se nahradí bajty načtenými ze souboru.

fileOffset

Int64

Pozice souboru, ze které se má číst.

Návraty

Int32

Celkový počet bajtů načtených do vyrovnávací paměti. To může být menší než počet bajtů přidělených ve vyrovnávací paměti, pokud tento počet bajtů není aktuálně k dispozici, nebo nula (0), pokud bylo dosaženo konce souboru.

Výjimky

ArgumentNullException

handle je null.

ArgumentException

Formát handle je neplatný.

ObjectDisposedException

Soubor je zavřený.

NotSupportedException

Soubor nepodporuje vyhledávání (kanál nebo soket).

ArgumentOutOfRangeException

fileOffset je negativní.

UnauthorizedAccessException

handle nebyl otevřen pro čtení.

IOException

Došlo k vstupně-výstupní chybě.

Poznámky

Umístění souboru není upřesňující.