Freigeben über


File.AppendAllTextAsync Methode

Definition

Überlädt

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Öffnet asynchron eine Datei oder erstellt die Datei, wenn sie noch nicht vorhanden ist, fügt die angegebene Zeichenfolge mithilfe der angegebenen Codierung an die Datei an und schließt dann die Datei.

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

Öffnet asynchron eine Datei oder erstellt eine Datei, wenn sie noch nicht vorhanden ist, fügt die angegebene Zeichenfolge an die Datei an und schließt dann die Datei.

AppendAllTextAsync(String, String, Encoding, CancellationToken)

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

Öffnet asynchron eine Datei oder erstellt die Datei, wenn sie noch nicht vorhanden ist, fügt die angegebene Zeichenfolge mithilfe der angegebenen Codierung an die Datei an und schließt dann die Datei.

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, an die die angegebene Zeichenfolge angefügt werden soll.

contents
String

Die Zeichenfolge, die an die Datei angefügt werden soll.

encoding
Encoding

Die zu verwendende Zeichencodierung.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Anfügevorgang 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 AppendAllText(String, String, Encoding)ausgelösten Ausnahmen.

Gilt für:

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

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllTextAsync : string * ReadOnlyMemory<char> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String
contents
ReadOnlyMemory<Char>
encoding
Encoding
cancellationToken
CancellationToken

Gibt zurück

Gilt für:

AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllTextAsync : string * ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String
contents
ReadOnlyMemory<Char>
cancellationToken
CancellationToken

Gibt zurück

Gilt für:

AppendAllTextAsync(String, String, CancellationToken)

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

Öffnet asynchron eine Datei oder erstellt eine Datei, wenn sie noch nicht vorhanden ist, fügt die angegebene Zeichenfolge an die Datei an und schließt dann die Datei.

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string contents, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, an die die angegebene Zeichenfolge angefügt werden soll.

contents
String

Die Zeichenfolge, die an die Datei angefügt werden soll.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Anfügevorgang 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 AppendAllText(String, String)ausgelösten Ausnahmen.

Gilt für: