File.AppendAllTextAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

AppendAllTextAsync(String, String, CancellationToken)	Apre in modo asincrono un file o crea un file, se non esiste già, aggiunge la stringa specificata al file e quindi lo chiude.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	Apre in modo asincrono un file o crea un file, se non esiste già, aggiunge la stringa specificata al file con la codifica specificata e quindi lo chiude.

AppendAllTextAsync(String, String, CancellationToken)

Origine:

File.cs

Apre in modo asincrono un file o crea un file, se non esiste già, aggiunge la stringa specificata al file e quindi lo chiude.

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

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

Parametri

path

String

File a cui aggiungere la stringa specificata.

contents

String

Stringa 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 AppendAllText(String, String).

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Origine:

File.cs

Apre in modo asincrono un file o crea un file, se non esiste già, aggiunge la stringa specificata al file con la codifica specificata e quindi lo chiude.

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

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

Parametri

path

String

File a cui aggiungere la stringa specificata.

contents

String

Stringa 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 AppendAllText(String, String, Encoding).