File.ReadAllLinesAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

ReadAllLinesAsync(String, CancellationToken)	Apre un file di testo in modo asincrono, ne legge tutte le righe e quindi lo chiude.
ReadAllLinesAsync(String, Encoding, CancellationToken)	Apre un file di testo in modo asincrono, ne legge tutte le righe con la codifica specificata e quindi lo chiude.

ReadAllLinesAsync(String, CancellationToken)

Origine:

File.cs

Apre un file di testo in modo asincrono, ne legge tutte le righe e quindi lo chiude.

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

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

Public Shared Function ReadAllLinesAsync (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 matrice di stringhe contenente tutte le righe del file.

Eccezioni

OperationCanceledException

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

Commenti

Questo metodo archivia nell'attività 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 ReadAllLines(String).

ReadAllLinesAsync(String, Encoding, CancellationToken)

Origine:

File.cs

Apre un file di testo in modo asincrono, ne legge tutte le righe con la codifica specificata e quindi lo chiude.

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

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

Public Shared Function ReadAllLinesAsync (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 matrice di stringhe contenente tutte le righe del file.

Eccezioni

OperationCanceledException

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

Commenti

Questo metodo archivia nell'attività 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 ReadAllLines(String, Encoding).