TextWriter.WriteAsync Methode

Definition

Namespace:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Schreibt Daten asynchron in den Textstream.

Überlädt

Name	Beschreibung
WriteAsync(Char[], Int32, Int32)	Schreibt asynchron ein Unterarray von Zeichen in den Textstream.
WriteAsync(StringBuilder, CancellationToken)	Schreibt asynchron einen Zeichenfolgen-Generator in den Textstream.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Schreibt asynchron einen Zeichenspeicherbereich in den Textstream.
WriteAsync(Char)	Schreibt asynchron ein Zeichen in den Textstream.
WriteAsync(String)	Schreibt eine Zeichenfolge asynchron in den Textstream.
WriteAsync(Char[])	Schreibt asynchron ein Zeichenarray in den Textstream.

WriteAsync(Char[], Int32, Int32)

Quelle:

TextWriter.cs

Schreibt asynchron ein Unterarray von Zeichen in den Textstream.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task WriteAsync(char[] buffer, int index, int count);

abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (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

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

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

ArgumentOutOfRangeException

index oder count ist negativ.

ObjectDisposedException

Der Textschreiber ist verworfen.

InvalidOperationException

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Die TextWriter Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Ein Beispiel für die Verwendung der WriteAsync Methode finden Sie unter der StreamWriter.WriteAsync 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 Write(Char[], Int32, Int32).

Weitere Informationen

• WriteAsync(Char[], Int32, Int32)
• WriteAsync(Char[], Int32, Int32)

WriteAsync(StringBuilder, CancellationToken)

Quelle:

TextWriter.cs

Schreibt asynchron einen Zeichenfolgen-Generator in den Textstream.

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

abstract member WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (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

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode entspricht dem Aufrufen WriteAsync(stringBuilder.ToString()), verwendet jedoch die StringBuilder.GetChunks() Methode, um das Erstellen der Zwischenzeichenfolge zu vermeiden.

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Quelle:

TextWriter.cs

Schreibt asynchron einen Zeichenspeicherbereich in den Textstream.

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

abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (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

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

WriteAsync(Char)

Quelle:

TextWriter.cs

Schreibt asynchron ein Zeichen in den Textstream.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);

public virtual System.Threading.Tasks.Task WriteAsync(char value);

abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As Char) As Task

Parameter

value

Char

Das Zeichen, das in den Textstream geschrieben werden soll.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Textschreiber ist verworfen.

InvalidOperationException

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Die TextWriter Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Ein Beispiel für die Verwendung der WriteAsync Methode finden Sie unter der StreamWriter.WriteAsync 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 Write(Char).

Weitere Informationen

• WriteAsync(Char)
• WriteAsync(Char)

WriteAsync(String)

Quelle:

TextWriter.cs

Schreibt eine Zeichenfolge asynchron in den Textstream.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);

public virtual System.Threading.Tasks.Task WriteAsync(string? value);

abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As String) As Task

Parameter

value

String

Die zu schreibende Zeichenfolge. Wenn value ja null, wird nichts in den Textstream geschrieben.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Textschreiber ist verworfen.

InvalidOperationException

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Die TextWriter Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Ein Beispiel für die Verwendung der WriteAsync Methode finden Sie unter der StreamWriter.WriteAsync 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 Write(String).

Weitere Informationen

• WriteAsync(String)
• WriteAsync(String)

WriteAsync(Char[])

Quelle:

TextWriter.cs

Schreibt asynchron ein Zeichenarray in den Textstream.

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteAsync(char[]? buffer);

member this.WriteAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteAsync (buffer As Char()) As Task

Parameter

buffer

Char[]

Das Zeichenarray, das in den Textstream geschrieben werden soll. Wenn buffer ja null, wird nichts geschrieben.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Textschreiber ist verworfen.

InvalidOperationException

Der Textschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

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

Weitere Informationen

• StreamWriter
• StringWriter