RandomAccess.ReadAsync Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.Runtime.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ValueTask<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í (potrubí nebo soket).

ArgumentOutOfRangeException

fileOffset je negativní.

UnauthorizedAccessException

handle nebyl otevřen pro čtení.

IOException

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

OperationCanceledException

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)