Udostępnij za pośrednictwem


File.AppendAllLinesAsync Metoda

Definicja

Przeciążenia

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Asynchronicznie dołącza wiersze do pliku, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze w pliku, a następnie zamyka plik.

AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

Asynchronicznie dołącza wiersze do pliku przy użyciu określonego kodowania, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze w pliku, a następnie zamyka plik.

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

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

Asynchronicznie dołącza wiersze do pliku, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze w pliku, a następnie zamyka plik.

public static System.Threading.Tasks.Task AppendAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllLinesAsync (path As String, contents As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path
String

Plik do dołączania wierszy do. Plik zostanie utworzony, jeśli jeszcze nie istnieje.

contents
IEnumerable<String>

Wiersze, które mają zostać dołączone 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 zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AppendAllLines(String, IEnumerable<String>)usługę .

Dotyczy

AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

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

Asynchronicznie dołącza wiersze do pliku przy użyciu określonego kodowania, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze w pliku, a następnie zamyka plik.

public static System.Threading.Tasks.Task AppendAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllLinesAsync (path As String, contents As IEnumerable(Of String), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path
String

Plik do dołączania wierszy do. Plik zostanie utworzony, jeśli jeszcze nie istnieje.

contents
IEnumerable<String>

Wiersze, które mają zostać dołączone 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 zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez AppendAllLines(String, IEnumerable<String>, Encoding)usługę .

Dotyczy