File.WriteAllTextAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

WriteAllTextAsync(String, String, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, je zkrácen a přepsán.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, je zkrácen a přepsán.

WriteAllTextAsync(String, String, CancellationToken)

Zdroj:

File.cs

Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, je zkrácen a přepsán.

public static System.Threading.Tasks.Task WriteAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function WriteAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path

String

Soubor, do který chcete zapisovat.

contents

String

Řetězec, který se má zapisovat do souboru.

cancellationToken

CancellationToken

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

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteAllText(String, String).

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Zdroj:

File.cs

Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, je zkrácen a přepsán.

public static System.Threading.Tasks.Task WriteAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

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

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

Parametry

path

String

Soubor, do který chcete zapisovat.

contents

String

Řetězec, který se má zapisovat do souboru.

encoding

Encoding

Kódování, které se má použít pro řetězec.

cancellationToken

CancellationToken

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

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteAllText(String, String, Encoding).