File.WriteAllLinesAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše do souboru zadané řádky a pak soubor zavře.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadané řádky do souboru pomocí zadaného kódování a pak soubor zavře.

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Zdroj:

File.cs

Asynchronně vytvoří nový soubor, zapíše do souboru zadané řádky a pak soubor zavře.

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

Parametry

path

String

Soubor, do který chcete zapisovat.

contents

IEnumerable<String>

Řádky, které se mají zapsat do souboru.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

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

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteAllLines(String, IEnumerable<String>).

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

Zdroj:

File.cs

Asynchronně vytvoří nový soubor, zapíše zadané řádky do souboru pomocí zadaného kódování a pak soubor zavře.

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

Parametry

path

String

Soubor, do který chcete zapisovat.

contents

IEnumerable<String>

Řádky, které se mají zapsat do souboru.

encoding

Encoding

Kódování znaků, které se mají použít.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

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

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteAllLines(String, IEnumerable<String>, Encoding).