File.WriteAllTextAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

WriteAllTextAsync(String, String, CancellationToken)	Crea un nuovo file in modo asincrono, vi scrive la stringa specificata e quindi lo chiude. Se il file di destinazione esiste già, viene troncato e sovrascritto.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Crea un nuovo file in modo asincrono, vi scrive la stringa specificata usando la codifica specificata e quindi lo chiude. Se il file di destinazione esiste già, viene troncato e sovrascritto.

WriteAllTextAsync(String, String, CancellationToken)

Origine:

File.cs

Crea un nuovo file in modo asincrono, vi scrive la stringa specificata e quindi lo chiude. Se il file di destinazione esiste già, viene troncato e sovrascritto.

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

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

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

Parametri

path

String

File in cui scrivere.

contents

String

Stringa da scrivere nel file.

cancellationToken

CancellationToken

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

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

OperationCanceledException

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

Commenti

Questo metodo archivia nell'attività che 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 WriteAllText(String, String).

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Origine:

File.cs

Crea un nuovo file in modo asincrono, vi scrive la stringa specificata usando la codifica specificata e quindi lo chiude. Se il file di destinazione esiste già, viene troncato e sovrascritto.

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

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

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

Parametri

path

String

File in cui scrivere.

contents

String

Stringa da scrivere nel file.

encoding

Encoding

Codifica da applicare alla stringa.

cancellationToken

CancellationToken

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

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

OperationCanceledException

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

Commenti

Questo metodo archivia nell'attività che 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 WriteAllText(String, String, Encoding).