TextWriter.WriteAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt Daten asynchron in den Textstream.
Überlädt
| WriteAsync(Char[], Int32, Int32) |
Schreibt ein Teilarray von Zeichen asynchron in den Textstream. |
| WriteAsync(StringBuilder, CancellationToken) |
Schreibt einen Zeichenfolgengenerator asynchron in den Textstream. |
| WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Schreibt eine Zeichenspeicherregion asynchron in den Textstream. |
| WriteAsync(String) |
Schreibt eine Zeichenfolge asynchron in den Textstream. |
| WriteAsync(Char[]) |
Schreibt ein Zeichenarray asynchron in den Textstream. |
| WriteAsync(Char) |
Schreibt ein Zeichen asynchron in den Textstream. |
WriteAsync(Char[], Int32, Int32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Teilarray von Zeichen asynchron 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);[System.Runtime.InteropServices.ComVisible(false)]
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[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As TaskParameter
- 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
Die TextWriter-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der WriteAsync -Methode finden Sie in der StreamWriter.WriteAsync -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 Write(Char[], Int32, Int32)Ausnahmen.
Weitere Informationen
Gilt für:
WriteAsync(StringBuilder, CancellationToken)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt einen Zeichenfolgengenerator asynchron 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.TaskPublic Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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
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 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 Write(StringBuilder)Ausnahmen.
Gilt für:
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt eine Zeichenspeicherregion asynchron 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.TaskPublic Overridable Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- 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.
Gilt für:
WriteAsync(String)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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);public virtual System.Threading.Tasks.Task WriteAsync (string? value);[System.Runtime.InteropServices.ComVisible(false)]
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[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (value As String) As TaskParameter
- value
- String
Die zu schreibende Zeichenfolge. Wenn value den Wert null hat, wird nichts in den Stream 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
Die TextWriter-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der WriteAsync -Methode finden Sie in der StreamWriter.WriteAsync -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 Write(String)Ausnahmen.
Weitere Informationen
Gilt für:
WriteAsync(Char[])
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Zeichenarray asynchron in den Textstream.
public:
System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);public System.Threading.Tasks.Task WriteAsync (char[] buffer);public System.Threading.Tasks.Task WriteAsync (char[]? buffer);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteAsync (char[] buffer);member this.WriteAsync : char[] -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteAsync : char[] -> System.Threading.Tasks.TaskPublic Function WriteAsync (buffer As Char()) As TaskParameter
- buffer
- Char[]
Das in den Textstream zu schreibende Zeichenarray. Wenn buffer den Wert null ist, wird nichts 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
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 Write(Char[])Ausnahmen.
Weitere Informationen
Gilt für:
WriteAsync(Char)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Zeichen asynchron in den Textstream.
public:
virtual System::Threading::Tasks::Task ^ WriteAsync(char value);public virtual System.Threading.Tasks.Task WriteAsync (char value);[System.Runtime.InteropServices.ComVisible(false)]
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[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (value As Char) As TaskParameter
- 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
Die TextWriter-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der WriteAsync -Methode finden Sie in der StreamWriter.WriteAsync -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 Write(Char)Ausnahmen.
