Freigeben über


File.WriteAllTextAsync Methode

Definition

Überlädt

WriteAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge mithilfe 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, ReadOnlyMemory<Char>, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge 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 dann die Datei. 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 mithilfe 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, ReadOnlyMemory<Char>, Encoding, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge mithilfe 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, ReadOnlyMemory<char> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member WriteAllTextAsync : string * ReadOnlyMemory<char> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, in die geschrieben werden soll.

contents
ReadOnlyMemory<Char>

Die Zeichen, die in die Datei geschrieben werden sollen.

encoding
Encoding

Die Codierung, die auf die Zeichenfolge angewendet werden soll.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. 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.

Gilt für:

WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge 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, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);
static member WriteAllTextAsync : string * ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, in die geschrieben werden soll.

contents
ReadOnlyMemory<Char>

Die Zeichen, die in die Datei geschrieben werden sollen.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. 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.

Gilt für:

WriteAllTextAsync(String, String, CancellationToken)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge 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.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, das auf Abbruchanforderungen überwacht werden soll. 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 Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteAllText(String, String)ausgelösten Ausnahmen.

Gilt für:

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Erstellt asynchron eine neue Datei, schreibt die angegebene Zeichenfolge mithilfe 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 Codierung, die auf die Zeichenfolge angewendet werden soll.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. 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 Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteAllText(String, String, Encoding)ausgelösten Ausnahmen.

Gilt für: