File.AppendAllLinesAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Aggiunge righe in modo asincrono a un file e quindi lo chiude. Se il file specificato non esiste, questo metodo ne crea uno, scrive la riga specificata e quindi lo chiude.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Aggiunge righe a un file in modo asincrono, usando una codifica specificata e quindi lo chiude. Se il file specificato non esiste, questo metodo ne crea uno, scrive la riga specificata e quindi lo chiude.

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Origine:

File.cs

Aggiunge righe in modo asincrono a un file e quindi lo chiude. Se il file specificato non esiste, questo metodo ne crea uno, scrive la riga specificata e quindi lo chiude.

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

Parametri

path

String

File in cui aggiungere righe. Se il file non esiste già, verrà creato.

contents

IEnumerable<String>

Righe da aggiungere al file.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di aggiunta asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AppendAllLines(String, IEnumerable<String>).

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

Origine:

File.cs

Aggiunge righe a un file in modo asincrono, usando una codifica specificata e quindi lo chiude. Se il file specificato non esiste, questo metodo ne crea uno, scrive la riga specificata e quindi lo chiude.

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

Parametri

path

String

File in cui aggiungere righe. Se il file non esiste già, verrà creato.

contents

IEnumerable<String>

Righe da aggiungere al file.

encoding

Encoding

Codifica dei caratteri da usare.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di aggiunta asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AppendAllLines(String, IEnumerable<String>, Encoding).