File.ReadAllTextAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

ReadAllTextAsync(String, CancellationToken)	Apre in modo asincrono un file di testo, legge tutto il testo nel file e quindi chiude il file.
ReadAllTextAsync(String, Encoding, CancellationToken)	Apre in modo asincrono un file di testo, legge tutto il testo nel file con la codifica specificata e quindi chiude il file.

ReadAllTextAsync(String, CancellationToken)

Origine:

File.cs

Apre in modo asincrono un file di testo, legge tutto il testo nel file e quindi chiude il file.

public static System.Threading.Tasks.Task<string> ReadAllTextAsync (string path, System.Threading.CancellationToken cancellationToken = default);

static member ReadAllTextAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

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

Parametri

path

String

File da aprire per la lettura.

cancellationToken

CancellationToken

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

Restituisce

Task<String>

Attività che rappresenta l'operazione di lettura asincrona, che esegue il wrapping della stringa contenente tutto il testo nel file.

Eccezioni

OperationCanceledException

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 ReadAllText(String).

ReadAllTextAsync(String, Encoding, CancellationToken)

Origine:

File.cs

Apre in modo asincrono un file di testo, legge tutto il testo nel file con la codifica specificata e quindi chiude il file.

public static System.Threading.Tasks.Task<string> ReadAllTextAsync (string path, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

static member ReadAllTextAsync : string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Shared Function ReadAllTextAsync (path As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task(Of String)

Parametri

path

String

File da aprire per la lettura.

encoding

Encoding

Codifica applicata al contenuto del file.

cancellationToken

CancellationToken

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

Restituisce

Task<String>

Attività che rappresenta l'operazione di lettura asincrona, che esegue il wrapping della stringa contenente tutto il testo nel file.

Eccezioni

OperationCanceledException

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 ReadAllText(String, Encoding).