File.AppendAllTextAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

AppendAllTextAsync(String, String, CancellationToken)	Asynchronně otevře soubor nebo vytvoří soubor, pokud ještě neexistuje, připojí zadaný řetězec k souboru a pak soubor zavře.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	Asynchronně otevře soubor nebo vytvoří soubor, pokud ještě neexistuje, připojí zadaný řetězec k souboru pomocí zadaného kódování a poté soubor zavře.

AppendAllTextAsync(String, String, CancellationToken)

Zdroj:

File.cs

Asynchronně otevře soubor nebo vytvoří soubor, pokud ještě neexistuje, připojí zadaný řetězec k souboru a pak soubor zavře.

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

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

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

Parametry

path

String

Soubor, ke který se má připojit zadaný řetězec.

contents

String

Řetězec, který se má připojit k 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 připojení.

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 AppendAllText(String, String).

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Zdroj:

File.cs

Asynchronně otevře soubor nebo vytvoří soubor, pokud ještě neexistuje, připojí zadaný řetězec k souboru pomocí zadaného kódování a poté soubor zavře.

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

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

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

Parametry

path

String

Soubor, ke který se má připojit zadaný řetězec.

contents

String

Řetězec, který se má připojit k souboru.

encoding

Encoding

Kódování znaků, které se mají použít.

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 připojení.

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 AppendAllText(String, String, Encoding).