File.ReadAllLinesAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

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, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task<String[]>

Úloha, která představuje 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 se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem 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é pro obsah souboru.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task<String[]>

Úloha, která představuje 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 se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadAllLines(String, Encoding).