File.ReadAllBytesAsync(String, CancellationToken) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

File.cs

Asynchronně otevře binární soubor, přečte obsah souboru do bajtového pole a pak soubor zavře.

public static System.Threading.Tasks.Task<byte[]> ReadAllBytesAsync(string path, System.Threading.CancellationToken cancellationToken = default);

static member ReadAllBytesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Shared Function ReadAllBytesAsync (path As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Byte())

Parametry

path

String

Soubor, který se má otevřít pro čtení.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.

Návraty

Task<Byte[]>

Úloha představující asynchronní operaci čtení, která zabalí pole bajtů obsahující obsah souboru.

Výjimky

OperationCanceledException

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

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadAllBytes(String).