Teilen über


TextWriter.WriteLineAsync Methode

Definition

Schreibt Daten asynchron in den Textstream, gefolgt von einem Zeilenterminator.

Überlädt

Name Beschreibung
WriteLineAsync(String, CancellationToken)
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt asynchron die Textdarstellung eines Zeichenspeicherbereichs in den Textstream, gefolgt von einem Zeilenterminator.

WriteLineAsync(CancellationToken)
WriteLineAsync(Rune)
WriteLineAsync(StringBuilder, CancellationToken)

Schreibt asynchron die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator.

WriteLineAsync(Char[])

Schreibt asynchron ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

WriteLineAsync(Char)

Schreibt asynchron ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

WriteLineAsync()

Schreibt asynchron einen Zeilenterminator in den Textstream.

WriteLineAsync(String)

Schreibt asynchron eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator.

WriteLineAsync(Char[], Int32, Int32)

Schreibt asynchron eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

Hinweise

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

WriteLineAsync(String, CancellationToken)

public:
 System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteLineAsync(string? value, System.Threading.CancellationToken cancellationToken);
member this.WriteLineAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteLineAsync (value As String, cancellationToken As CancellationToken) As Task

Parameter

value
String
cancellationToken
CancellationToken

Gibt zurück

Gilt für:

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

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

Schreibt asynchron die Textdarstellung eines Zeichenspeicherbereichs in den Textstream, gefolgt von einem Zeilenterminator.

public virtual System.Threading.Tasks.Task WriteLineAsync(ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
abstract member WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

buffer
ReadOnlyMemory<Char>

Der Zeichenspeicherbereich, der in den Textstream 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

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

Gilt für:

WriteLineAsync(CancellationToken)

public:
 System::Threading::Tasks::Task ^ WriteLineAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteLineAsync(System.Threading.CancellationToken cancellationToken);
member this.WriteLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteLineAsync (cancellationToken As CancellationToken) As Task

Parameter

cancellationToken
CancellationToken

Gibt zurück

Gilt für:

WriteLineAsync(Rune)

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(System::Text::Rune value);
public virtual System.Threading.Tasks.Task WriteLineAsync(System.Text.Rune value);
abstract member WriteLineAsync : System.Text.Rune -> System.Threading.Tasks.Task
override this.WriteLineAsync : System.Text.Rune -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As Rune) As Task

Parameter

value
Rune

Gibt zurück

Gilt für:

WriteLineAsync(StringBuilder, CancellationToken)

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

Schreibt asynchron die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator.

public virtual System.Threading.Tasks.Task WriteLineAsync(System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);
abstract member WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

value
StringBuilder

Die Zeichenfolge als Zeichenfolgen-Generator, um in den Textstream zu schreiben.

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

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine(StringBuilder).

Gilt für:

WriteLineAsync(Char[])

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

Schreibt asynchron ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

public:
 System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer);
public System.Threading.Tasks.Task WriteLineAsync(char[] buffer);
public System.Threading.Tasks.Task WriteLineAsync(char[]? buffer);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteLineAsync(char[] buffer);
member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task
Public Function WriteLineAsync (buffer As Char()) As Task

Parameter

buffer
Char[]

Das Zeichenarray, das in den Textstream geschrieben werden soll. Wenn das Zeichenarray lautet null, wird nur der Zeilenterminator geschrieben.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textschreiber ist verworfen.

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine(Char[]).

Weitere Informationen

Gilt für:

WriteLineAsync(Char)

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

Schreibt asynchron ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(char value);
public virtual System.Threading.Tasks.Task WriteLineAsync(char value);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync(char value);
abstract member WriteLineAsync : char -> System.Threading.Tasks.Task
override this.WriteLineAsync : char -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : char -> System.Threading.Tasks.Task
override this.WriteLineAsync : char -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As Char) As Task

Parameter

value
Char

Das Zeichen, das in den Textstream geschrieben werden soll.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textschreiber ist verworfen.

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

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

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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine(Char).

Weitere Informationen

Gilt für:

WriteLineAsync()

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

Schreibt asynchron einen Zeilenterminator in den Textstream.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync();
public virtual System.Threading.Tasks.Task WriteLineAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync();
abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync () As Task

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textschreiber ist verworfen.

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine().

Weitere Informationen

Gilt für:

WriteLineAsync(String)

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

Schreibt asynchron eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);
public virtual System.Threading.Tasks.Task WriteLineAsync(string value);
public virtual System.Threading.Tasks.Task WriteLineAsync(string? value);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync(string value);
abstract member WriteLineAsync : string -> System.Threading.Tasks.Task
override this.WriteLineAsync : string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : string -> System.Threading.Tasks.Task
override this.WriteLineAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As String) As Task

Parameter

value
String

Die zu schreibende Zeichenfolge. Wenn der Wert lautet null, wird nur ein Zeilenterminator geschrieben.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der Textschreiber ist verworfen.

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

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

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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine(String).

Weitere Informationen

Gilt für:

WriteLineAsync(Char[], Int32, Int32)

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

Schreibt asynchron eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteLineAsync(char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync(char[] buffer, int index, int count);
abstract member WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

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.

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

index oder count ist negativ.

Der Textschreiber ist verworfen.

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine(Char[], Int32, Int32).

Weitere Informationen

Gilt für: