File.WriteAllTextAsync Methode

Definition

Überlädt

WriteAllTextAsync(String, String, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge in die Datei und schließt die Datei dann. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge unter Verwendung der angegebenen Codierung in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

WriteAllTextAsync(String, String, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge in die Datei und schließt die Datei dann. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

public static System.Threading.Tasks.Task WriteAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);
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

Parameter

path
String

Die Datei, in die geschrieben werden soll.

contents
String

Die Zeichenfolge, die in die Datei geschrieben werden soll.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteAllText(String, String).

Gilt für:

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge unter Verwendung der angegebenen Codierung in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

public static System.Threading.Tasks.Task WriteAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
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

Parameter

path
String

Die Datei, in die geschrieben werden soll.

contents
String

Die Zeichenfolge, die in die Datei geschrieben werden soll.

encoding
Encoding

Die auf die Zeichenfolge anzuwendende Codierung.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteAllText(String, String, Encoding).

Gilt für: