File.AppendAllTextAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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).