File.ReadAllLinesAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
ReadAllLinesAsync(String, CancellationToken)	Asynchronně otevře textový soubor, přečte všechny řádky souboru a pak soubor zavře.
ReadAllLinesAsync(String, Encoding, CancellationToken)	Asynchronně otevře textový soubor, přečte všechny řádky souboru se zadaným kódováním a pak soubor zavře.

ReadAllLinesAsync(String, CancellationToken)

Zdroj:

File.cs

Asynchronně otevře textový soubor, přečte všechny řádky souboru a pak soubor zavře.

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

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<String[]>

Úloha představující asynchronní operaci čtení, která zabalí pole řetězců obsahující všechny řádky 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é ReadAllLines(String).

ReadAllLinesAsync(String, Encoding, CancellationToken)

Zdroj:

File.cs

Asynchronně otevře textový soubor, přečte všechny řádky souboru se zadaným kódováním a pak soubor zavře.

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

Parametry

path

String

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

encoding

Encoding

Kódování použité na obsah souboru.

cancellationToken

CancellationToken

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

Návraty

Task<String[]>

Úloha představující asynchronní operaci čtení, která zabalí pole řetězců obsahující všechny řádky 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é ReadAllLines(String, Encoding).