File.WriteAllLinesAsync Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchronicznie tworzy nowy plik, zapisuje określone wiersze w pliku, a następnie zamyka plik.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchronicznie tworzy nowy plik, zapisuje określone wiersze w pliku przy użyciu określonego kodowania, a następnie zamyka plik.

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Źródło:

File.cs

Asynchronicznie tworzy nowy plik, zapisuje określone wiersze w pliku, a następnie zamyka plik.

public static System.Threading.Tasks.Task WriteAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);

static member WriteAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path

String

Plik do zapisania.

contents

IEnumerable<String>

Wiersze do zapisu w pliku.

cancellationToken

CancellationToken

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

Zwraca

Task

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

OperationCanceledException

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

Uwagi

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez WriteAllLines(String, IEnumerable<String>)usługę .

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

Źródło:

File.cs

Asynchronicznie tworzy nowy plik, zapisuje określone wiersze w pliku przy użyciu określonego kodowania, a następnie zamyka plik.

public static System.Threading.Tasks.Task WriteAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

static member WriteAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

path

String

Plik do zapisania.

contents

IEnumerable<String>

Wiersze do zapisu w pliku.

encoding

Encoding

Kodowanie znaków do użycia.

cancellationToken

CancellationToken

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

Zwraca

Task

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

OperationCanceledException

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

Uwagi

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez WriteAllLines(String, IEnumerable<String>, Encoding)usługę .