File.ReadAllBytesAsync(String, CancellationToken) Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

File.cs

Öffnet eine Binärdatei asynchron, liest den Inhalt der Datei in ein Bytearray ein und schließt dann die Datei.

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())

Parameter

path

String

Die Datei, die zum Lesen geöffnet werden soll.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Task<Byte[]>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt, der das Bytearray umschließt, das den gesamten Inhalt der Datei enthält.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ReadAllBytes(String)Ausnahmen.