Auf Englisch lesen

Teilen über


TextWriter.WriteLineAsync Methode

Definition

Schreibt Daten, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

Überlädt

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt die Textdarstellung einer Zeichenspeicherregion, auf die ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

WriteLineAsync(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

WriteLineAsync(Char[])

Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

WriteLineAsync(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

WriteLineAsync()

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Textstream.

WriteLineAsync(StringBuilder, CancellationToken)

Schreibt die Textdarstellung eines Zeichenfolgengenerators, auf die ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

WriteLineAsync(Char)

Schreibt ein Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

Hinweise

Die TextWriter-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der WriteLineAsync -Methode finden Sie in der StreamWriter.WriteLineAsync -Methode.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt die Textdarstellung einer Zeichenspeicherregion, auf die ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

C#
public virtual System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

Parameter

buffer
ReadOnlyMemory<Char>

Die in den Textstream zu schreibende Zeichenspeicherregion.

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

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

WriteLineAsync(String)

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

C#
public virtual System.Threading.Tasks.Task WriteLineAsync (string value);
C#
public virtual System.Threading.Tasks.Task WriteLineAsync (string? value);
C#
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync (string value);

Parameter

value
String

Die zu schreibende Zeichenfolge. Wenn der Wert null ist, wird nur ein Zeichen für den Zeilenabschluss geschrieben.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

Die TextWriter-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der WriteLineAsync -Methode finden Sie in der StreamWriter.WriteLineAsync -Methode.

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 WriteLine(String)Ausnahmen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteLineAsync(Char[])

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

C#
public System.Threading.Tasks.Task WriteLineAsync (char[] buffer);
C#
public System.Threading.Tasks.Task WriteLineAsync (char[]? buffer);
C#
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteLineAsync (char[] buffer);

Parameter

buffer
Char[]

Das in den Textstream zu schreibende Zeichenarray. Wenn das Zeichenarray null ist, wird nur das Zeichen für den Zeilenabschluss geschrieben.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

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 WriteLine(Char[])Ausnahmen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteLineAsync(Char[], Int32, Int32)

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Textstream.

C#
public virtual System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);
C#
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

Parameter

buffer
Char[]

Das Zeichenarray, aus dem Daten geschrieben werden sollen.

index
Int32

Die Zeichenposition im Puffer, an der mit dem Abrufen von Daten begonnen werden soll.

count
Int32

Die Anzahl der zu schreibenden Zeichen.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

buffer ist null.

index plus count ist größer als die Pufferlänge.

index oder count ist ein negativer Wert.

Der Textwriter wird freigegeben.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

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 WriteLine(Char[], Int32, Int32)Ausnahmen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteLineAsync()

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Textstream.

C#
public virtual System.Threading.Tasks.Task WriteLineAsync ();
C#
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync ();

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

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 WriteLine()Ausnahmen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteLineAsync(StringBuilder, CancellationToken)

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt die Textdarstellung eines Zeichenfolgengenerators, auf die ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

C#
public virtual System.Threading.Tasks.Task WriteLineAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

Parameter

value
StringBuilder

Die Zeichenfolge, die als Zeichenfolgengenerator in den Textstream 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

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

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 WriteLine(StringBuilder)Ausnahmen.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

WriteLineAsync(Char)

Quelle:
TextWriter.cs
Quelle:
TextWriter.cs
Quelle:
TextWriter.cs

Schreibt ein Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, asynchron in den Textstream.

C#
public virtual System.Threading.Tasks.Task WriteLineAsync (char value);
C#
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync (char value);

Parameter

value
Char

Das in den Textstream zu schreibende Zeichen.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.

Die TextWriter-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der WriteLineAsync -Methode finden Sie in der StreamWriter.WriteLineAsync -Methode.

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 WriteLine(Char)Ausnahmen.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0