File.ReadAllBytesAsync(String, CancellationToken) Metodo

Definizione

Apre in modo asincrono un file binario, legge il contenuto del file in una matrice di byte e quindi chiude il file.

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

Parametri

path
String

File da aprire per la lettura.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Valori restituiti

Task<Byte[]>

Attività che rappresenta l'operazione di lettura asincrona, che esegue il wrapping della matrice di byte contenente il contenuto del file.

Eccezioni

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ReadAllBytes(String).

Si applica a