Sdílet prostřednictvím


RandomAccess.ReadAsync Metoda

Definice

Přetížení

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

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

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

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

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs

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

public static System.Threading.Tasks.ValueTask<long> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);
static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>
Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)

Parametry

handle
SafeFileHandle

Popisovač souboru.

buffers
IReadOnlyList<Memory<Byte>>

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

fileOffset
Int64

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

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

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

handle nebo buffers je null.

Formát handle je neplatný.

Soubor je zavřený.

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

fileOffset je negativní.

handle nebyl otevřen pro čtení.

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

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).

Platí pro

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs

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

public static System.Threading.Tasks.ValueTask<int> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);
static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametry

handle
SafeFileHandle

Popisovač souboru.

buffer
Memory<Byte>

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

fileOffset
Int64

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

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

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

handle je null.

Formát handle je neplatný.

Soubor je zavřený.

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

fileOffset je negativní.

handle nebyl otevřen pro čtení.

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

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

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

Platí pro