File.AppendAllTextAsync Metoda

Definice

Přetížení

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 pak soubor zavře.

AppendAllTextAsync(String, ReadOnlyMemory<Char>, 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 pak soubor zavře.

AppendAllTextAsync(String, ReadOnlyMemory<Char>, 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, 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)

Zdroj:
File.cs
Zdroj:
File.cs
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 pak soubor zavře.

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

Parametry

path
String

Soubor pro připojení zadaného řetězce.

contents
String

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

encoding
Encoding

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

cancellationToken
CancellationToken

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

Návraty

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

Výjimky

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

Platí pro

.NET 10 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1

AppendAllTextAsync(String, ReadOnlyMemory<Char>, 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 pak soubor zavře.

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

Parametry

path
String

Soubor pro připojení zadaného řetězce.

contents
ReadOnlyMemory<Char>

Znaky, které se mají k souboru připojit.

encoding
Encoding

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

cancellationToken
CancellationToken

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

Návraty

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

Výjimky

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

Platí pro

.NET 10 a .NET 9
Produkt Verze
.NET 9, 10

AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

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, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);

Parametry

path
String

Soubor pro připojení zadaného řetězce.

contents
ReadOnlyMemory<Char>

Znaky, které se mají k souboru připojit.

cancellationToken
CancellationToken

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

Návraty

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

Výjimky

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

Platí pro

.NET 10 a .NET 9
Produkt Verze
.NET 9, 10

AppendAllTextAsync(String, String, CancellationToken)

Zdroj:
File.cs
Zdroj:
File.cs
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);
public static System.Threading.Tasks.Task AppendAllTextAsync(string path, string contents, System.Threading.CancellationToken cancellationToken = default);

Parametry

path
String

Soubor pro připojení zadaného řetězce.

contents
String

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

cancellationToken
CancellationToken

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

Návraty

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

Výjimky

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

Platí pro

.NET 10 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1