TextWriter.WriteAsync Metoda

Definicja

Zapisuje dane w strumieniu tekstowym asynchronicznie.Writes data to the text stream asynchronously.

Przeciążenia

WriteAsync(Char[], Int32, Int32)

Zapisuje podtablicę znaków w strumieniu tekstowym asynchronicznie.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje konstruktora ciągów do strumienia tekstu.Asynchronously writes a string builder to the text stream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje region pamięci znaku w strumieniu tekstowym.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.Writes a string to the text stream asynchronously.

WriteAsync(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.Writes a character array to the text stream asynchronously.

WriteAsync(Char)

Zapisuje znak w strumieniu tekstowym asynchronicznie.Writes a character to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

Zapisuje podtablicę znaków w strumieniu tekstowym asynchronicznie.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

Parametry

buffer
Char[]

Tablica znaków, z której mają zostać zapisane dane.The character array to write data from.

index
Int32

Pozycja znaku w buforze, od którego ma zostać rozpoczęte pobieranie danych.The character position in the buffer at which to start retrieving data.

count
Int32

Liczba znaków, jaka ma zostać zapisana.The number of characters to write.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Parametr buffer ma wartość null.buffer is null.

index Plus count jest większa niż długość buforu.The index plus count is greater than the buffer length.

index lub count jest wartością ujemną.index or count is negative.

Moduł zapisujący tekstu jest usuwany.The text writer is disposed.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.The text writer is currently in use by a previous write operation.

Uwagi

Klasa TextWriter jest klasą abstrakcyjną.The TextWriter class is an abstract class. W związku z tym, nie tworzy się obiektu w kodzie.Therefore, you do not instantiate it in your code. Przykład użycia metody WriteAsync można znaleźć w StreamWriter.WriteAsync metodzie.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Zobacz też

WriteAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje konstruktora ciągów do strumienia tekstu.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

Parametry

value
StringBuilder

Ciąg, jako Konstruktor ciągów, do zapisu w strumieniu tekstu.The string, as a string builder, to write to the text stream.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania.The token to monitor for cancellation requests. Wartość domyślna to None.The default value is None.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Uwagi

Ta metoda jest równoznaczna z wywołaniem WriteAsync(stringBuilder.ToString()), ale używa metody StringBuilder.GetChunks(), aby uniknąć tworzenia ciągu pośredniego.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)

Asynchronicznie zapisuje region pamięci znaku w strumieniu tekstowym.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

Parametry

buffer
ReadOnlyMemory<Char>

Region pamięci znaku do zapisu w strumieniu tekstowym.The character memory region to write to the text stream.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania.The token to monitor for cancellation requests. Wartość domyślna to None.The default value is None.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

WriteAsync(String)

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.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

Parametry

value
String

Ciąg do zapisu.The string to write. Jeśli value jest null, nic nie jest zapisywana w strumieniu tekstu.If value is null, nothing is written to the text stream.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Moduł zapisujący tekstu jest usuwany.The text writer is disposed.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.The text writer is currently in use by a previous write operation.

Uwagi

Klasa TextWriter jest klasą abstrakcyjną.The TextWriter class is an abstract class. W związku z tym, nie tworzy się obiektu w kodzie.Therefore, you do not instantiate it in your code. Przykład użycia metody WriteAsync można znaleźć w StreamWriter.WriteAsync metodzie.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Zobacz też

WriteAsync(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.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

Parametry

buffer
Char[]

Tablica znaków do zapisu w strumieniu tekstowym.The character array to write to the text stream. Jeśli buffer jest null, nic nie jest zapisywana.If buffer is null, nothing is written.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Moduł zapisujący tekstu jest usuwany.The text writer is disposed.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.The text writer is currently in use by a previous write operation.

Zobacz też

WriteAsync(Char)

Zapisuje znak w strumieniu tekstowym asynchronicznie.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

Parametry

value
Char

Znak do zapisu w strumieniu tekstu.The character to write to the text stream.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Moduł zapisujący tekstu jest usuwany.The text writer is disposed.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.The text writer is currently in use by a previous write operation.

Uwagi

Klasa TextWriter jest klasą abstrakcyjną.The TextWriter class is an abstract class. W związku z tym, nie tworzy się obiektu w kodzie.Therefore, you do not instantiate it in your code. Przykład użycia metody WriteAsync można znaleźć w StreamWriter.WriteAsync metodzie.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Zobacz też

Dotyczy