File.AppendAllLinesAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchronně připojí řádky k souboru a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a poté soubor zavře.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchronně připojí řádky k souboru pomocí zadaného kódování a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a poté soubor zavře.

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Zdroj:

File.cs

Asynchronně připojí řádky k souboru a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a poté soubor zavře.

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

Soubor, ke který chcete připojit řádky. Soubor se vytvoří, pokud ještě neexistuje.

contents

IEnumerable<String>

Řádky, které se mají připojit k 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 připojení.

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 AppendAllLines(String, IEnumerable<String>).

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

Zdroj:

File.cs

Asynchronně připojí řádky k souboru pomocí zadaného kódování a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a poté soubor zavře.

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

Soubor, ke který chcete připojit řádky. Soubor se vytvoří, pokud ještě neexistuje.

contents

IEnumerable<String>

Řádky, které se mají připojit k 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 připojení.

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 AppendAllLines(String, IEnumerable<String>, Encoding).