Sdílet prostřednictvím

File.AppendAllTextAsync Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.FileSystem.dll
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll

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

Task

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

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

Platí pro

AppendAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken) 

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllTextAsync : string * ReadOnlyMemory<char> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path
String
contents
ReadOnlyMemory<Char>
encoding
Encoding
cancellationToken
CancellationToken

Návraty

Task

Platí pro

AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken) 

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllTextAsync : string * ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path
String
contents
ReadOnlyMemory<Char>
cancellationToken
CancellationToken

Návraty

Task

Platí pro

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);
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 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

Task

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

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

Platí pro