File.WriteAllTextAsync Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

WriteAllTextAsync(String, String, CancellationToken)	Crée un fichier de façon asynchrone, écrit la chaîne spécifiée dans le fichier, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Crée un fichier de façon asynchrone, écrit la chaîne spécifiée dans le fichier en utilisant l’encodage spécifié, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.

WriteAllTextAsync(String, String, CancellationToken)

Source:

File.cs

Crée un fichier de façon asynchrone, écrit la chaîne spécifiée dans le fichier, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.

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

Paramètres

path

String

Fichier dans lequel écrire.

contents

String

Chaîne à écrire dans le fichier.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.

Retours

Task

Tâche qui représente l’opération d’écriture asynchrone.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteAllText(String, String).

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Source:

File.cs

Crée un fichier de façon asynchrone, écrit la chaîne spécifiée dans le fichier en utilisant l’encodage spécifié, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.

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

Paramètres

path

String

Fichier dans lequel écrire.

contents

String

Chaîne à écrire dans le fichier.

encoding

Encoding

Encodage à appliquer à la chaîne.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.

Retours

Task

Tâche qui représente l’opération d’écriture asynchrone.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteAllText(String, String, Encoding).