File.WriteAllTextAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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.
