Udostępnij za pośrednictwem


File.AppendAllTextAsync Metoda

Definicja

Przeciążenia

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku przy użyciu określonego kodowania, a następnie zamyka plik.

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

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku przy użyciu określonego kodowania, a następnie zamyka plik.

AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku, a następnie zamyka plik.

AppendAllTextAsync(String, String, CancellationToken)

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku, a następnie zamyka plik.

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku przy użyciu określonego kodowania, a następnie zamyka plik.

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

Plik dołączany do określonego ciągu.

contents
String

Ciąg, który ma być dołączany do pliku.

encoding
Encoding

Kodowanie znaków do użycia.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Zadanie reprezentujące operację dołączania asynchronicznego.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez AppendAllText(String, String, Encoding).

Dotyczy

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

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku przy użyciu określonego kodowania, a następnie zamyka plik.

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

Plik dołączany do określonego ciągu.

contents
ReadOnlyMemory<Char>

Znaki, które mają być dołączane do pliku.

encoding
Encoding

Kodowanie znaków do użycia.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Zadanie reprezentujące operację dołączania asynchronicznego.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy

AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku, a następnie zamyka plik.

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

Plik dołączany do określonego ciągu.

contents
ReadOnlyMemory<Char>

Znaki, które mają być dołączane do pliku.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Zadanie reprezentujące operację dołączania asynchronicznego.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy

AppendAllTextAsync(String, String, CancellationToken)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Asynchronicznie otwiera plik lub tworzy plik, jeśli jeszcze nie istnieje, dołącza określony ciąg do pliku, a następnie zamyka plik.

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

Plik dołączany do określonego ciągu.

contents
String

Ciąg, który ma być dołączany do pliku.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Zadanie reprezentujące operację dołączania asynchronicznego.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez AppendAllText(String, String).

Dotyczy