Freigeben über


File.WriteAllLinesAsync Methode

Definition

Überlädt

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.

WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt die angegebenen Zeilen unter Verwendung der angegebenen Codierung in die Datei und schließt dann die Datei.

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)

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

Erstellt asynchron eine neue Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.

public static System.Threading.Tasks.Task WriteAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);
static member WriteAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, in die geschrieben werden soll.

contents
IEnumerable<String>

Die Zeilen, die in die Datei geschrieben werden sollen.

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 sie 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteAllLines(String, IEnumerable<String>)Ausnahmen.

Gilt für:

WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

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

Erstellt asynchron eine neue Datei, schreibt die angegebenen Zeilen unter Verwendung der angegebenen Codierung in die Datei und schließt dann die Datei.

public static System.Threading.Tasks.Task WriteAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member WriteAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, in die geschrieben werden soll.

contents
IEnumerable<String>

Die Zeilen, die in die Datei geschrieben werden sollen.

encoding
Encoding

Die zu verwendende Zeichencodierung.

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 sie 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteAllLines(String, IEnumerable<String>, Encoding)Ausnahmen.

Gilt für: