TextWriter.WriteAsync Methode

Definition

Schreibt Daten asynchron in den Textstream.Writes data to the text stream asynchronously.

Überlädt

WriteAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen asynchron in den Textstream.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken)

Schreibt einen Zeichenfolgengenerator asynchron in den Textstream.Asynchronously writes a string builder to the text stream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt eine Zeichenspeicherregion asynchron in den Textstream.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

Schreibt eine Zeichenfolge asynchron in den Textstream.Writes a string to the text stream asynchronously.

WriteAsync(Char[])

Schreibt ein Zeichenarray asynchron in den Textstream.Writes a character array to the text stream asynchronously.

WriteAsync(Char)

Schreibt ein Zeichen asynchron in den Textstream.Writes a character to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen asynchron in den Textstream.Writes a subarray of characters to the text stream asynchronously.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(cli::array <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
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.The character array to write data from.

index
Int32

Die Zeichenposition im Puffer, an der mit dem Abrufen von Daten begonnen werden soll.The character position in the buffer at which to start retrieving data.

count
Int32

Die Anzahl der zu schreibenden Zeichen.The number of characters to write.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Attribute

Ausnahmen

buffer ist null.buffer is null.

index plus count ist größer als die Pufferlänge.The index plus count is greater than the buffer length.

index oder count ist ein negativer Wert.index or count is negative.

Der Textwriter wird freigegeben.The text writer is disposed.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The text writer is currently in use by a previous write operation.

Hinweise

Die TextWriter -Klasse stellt eine abstrakte Klasse dar.The TextWriter class is an abstract class. Daher wird Sie nicht im Code instanziiert.Therefore, you do not instantiate it in your code. Ein Beispiel für die Verwendung der WriteAsync-Methode finden Sie in der StreamWriter.WriteAsync-Methode.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Siehe auch

WriteAsync(StringBuilder, CancellationToken)

Schreibt einen Zeichenfolgengenerator asynchron in den Textstream.Asynchronously writes a string builder to the text stream.

public virtual System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder value, System.Threading.CancellationToken cancellationToken = null);
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

Parameter

value
StringBuilder

Die Zeichenfolge, die als Zeichenfolgengenerator in den Textstream geschrieben werden soll.The string, as a string builder, to write to the text stream.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.The token to monitor for cancellation requests. Der Standardwert ist None.The default value is None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Hinweise

Diese Methode entspricht dem Aufrufen von WriteAsync(stringBuilder.ToString()). es wird jedoch die StringBuilder.GetChunks()-Methode verwendet, um zu vermeiden, dass die zwischen Zeichenfolge erstellt wird.This method is equivalent to calling WriteAsync(stringBuilder.ToString()), however, it uses the StringBuilder.GetChunks() method to avoid creating the intermediate string.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt eine Zeichenspeicherregion asynchron in den Textstream.Asynchronously writes a character memory region to the text stream.

public virtual System.Threading.Tasks.Task WriteAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = null);
abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Parameter

buffer
ReadOnlyMemory<Char>

Die in den Textstream zu schreibende Zeichenspeicherregion.The character memory region to write to the text stream.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.The token to monitor for cancellation requests. Der Standardwert ist None.The default value is None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

WriteAsync(String)

Schreibt eine Zeichenfolge asynchron in den Textstream.Writes a string to the text stream asynchronously.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::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
Public Overridable Function WriteAsync (value As String) As Task

Parameter

value
String

Die zu schreibende Zeichenfolge.The string to write. Wenn value den Wert null hat, wird nichts in den Stream geschrieben.If value is null, nothing is written to the text stream.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.The text writer is disposed.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The text writer is currently in use by a previous write operation.

Hinweise

Die TextWriter -Klasse stellt eine abstrakte Klasse dar.The TextWriter class is an abstract class. Daher wird Sie nicht im Code instanziiert.Therefore, you do not instantiate it in your code. Ein Beispiel für die Verwendung der WriteAsync-Methode finden Sie in der StreamWriter.WriteAsync-Methode.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Siehe auch

WriteAsync(Char[])

Schreibt ein Zeichenarray asynchron in den Textstream.Writes a character array to the text stream asynchronously.

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);
[System.Runtime.InteropServices.ComVisible(false)]
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 in den Textstream zu schreibende Zeichenarray.The character array to write to the text stream. Wenn buffer den Wert null ist, wird nichts geschrieben.If buffer is null, nothing is written.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.The text writer is disposed.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The text writer is currently in use by a previous write operation.

Siehe auch

WriteAsync(Char)

Schreibt ein Zeichen asynchron in den Textstream.Writes a character to the text stream asynchronously.

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
Public Overridable Function WriteAsync (value As Char) As Task

Parameter

value
Char

Das in den Textstream zu schreibende Zeichen.The character to write to the text stream.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Attribute

Ausnahmen

Der Textwriter wird freigegeben.The text writer is disposed.

Der Textwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The text writer is currently in use by a previous write operation.

Hinweise

Die TextWriter -Klasse stellt eine abstrakte Klasse dar.The TextWriter class is an abstract class. Daher wird Sie nicht im Code instanziiert.Therefore, you do not instantiate it in your code. Ein Beispiel für die Verwendung der WriteAsync-Methode finden Sie in der StreamWriter.WriteAsync-Methode.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Siehe auch

Gilt für: