File.ReadAllTextAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

ReadAllTextAsync(String, CancellationToken)	Asynchronně otevře textový soubor, přečte veškerý text v souboru a pak soubor zavře.
ReadAllTextAsync(String, Encoding, CancellationToken)	Asynchronně otevře textový soubor, přečte veškerý text v souboru se zadaným kódováním a pak soubor zavře.

ReadAllTextAsync(String, CancellationToken)

Zdroj:

File.cs

Asynchronně otevře textový soubor, přečte veškerý text v souboru a pak soubor zavře.

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)

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á zalomí řetězec obsahující veškerý text v 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ě. U uložených výjimek se podívejte na výjimky vyvolané ReadAllText(String).

ReadAllTextAsync(String, Encoding, CancellationToken)

Zdroj:

File.cs

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

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)

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á zalomí řetězec obsahující veškerý text v 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ě. U uložených výjimek se podívejte na výjimky vyvolané ReadAllText(String, Encoding).