TextWriter.WriteAsync TextWriter.WriteAsync TextWriter.WriteAsync TextWriter.WriteAsync Method

Определение

Выполняет асинхронную запись данных в текстовый поток.Writes data to the text stream asynchronously.

Перегрузки

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

Асинхронно записывает подмассив символов в текстовый поток.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)

Асинхронно записывает построитель строки в текстовый поток.Asynchronously writes a string builder to the text stream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Выполняет асинхронную запись области памяти символов в текстовый поток.Asynchronously writes a character memory region to the text stream.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Выполняет асинхронную запись строки в текстовый поток.Writes a string to the text stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

Выполняет асинхронную запись массива символов в текстовый поток.Writes a character array to the text stream asynchronously.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Выполняет асинхронную запись символа в текстовый поток.Writes a character to the text stream asynchronously.

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

Асинхронно записывает подмассив символов в текстовый поток.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

Параметры

buffer
Char[]

Массив символов, из которого записываются данные.The character array to write data from.

index
Int32 Int32 Int32 Int32

Положение символа в буфере, с которого начинается извлечение данных.The character position in the buffer at which to start retrieving data.

count
Int32 Int32 Int32 Int32

Количество символов для записи.The number of characters to write.

Возвраты

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Исключения

Свойство buffer имеет значение null.buffer is null.

Сумма значений параметров index и count превышает длину буфера.The index plus count is greater than the buffer length.

index или count является отрицательным значением.index or count is negative.

Удалено средство записи текста.The text writer is disposed.

Средство записи текста в настоящее время используется предыдущей операцией записи.The text writer is currently in use by a previous write operation.

Комментарии

Класс TextWriter является абстрактным.The TextWriter class is an abstract class. Следовательно, в коде экземпляр этого объекта не создается.Therefore, you do not instantiate it in your code. Пример использования WriteAsync метода см. в StreamWriter.WriteAsync описании метода.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Дополнительно

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)

Асинхронно записывает построитель строки в текстовый поток.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

Параметры

value
StringBuilder StringBuilder StringBuilder StringBuilder

Строка как построитель строки для записи в текстовый поток.The string, as a string builder, to write to the text stream.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен для отслеживания запросов отмены.The token to monitor for cancellation requests. Значение по умолчанию — None.The default value is None.

Возвраты

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Комментарии

Этот метод эквивалентен вызову WriteAsync(stringBuilder.ToString()), однако он StringBuilder.GetChunks() использует метод, чтобы избежать создания промежуточной строки.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) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Выполняет асинхронную запись области памяти символов в текстовый поток.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

Параметры

buffer
ReadOnlyMemory<Char>

Область памяти символов для записи в текстовый поток.The character memory region to write to the text stream.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен для отслеживания запросов отмены.The token to monitor for cancellation requests. Значение по умолчанию — None.The default value is None.

Возвраты

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Выполняет асинхронную запись строки в текстовый поток.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

Параметры

value
String String String String

Строка для записи.The string to write. Если параметр value имеет значение null, в текстовый поток ничего не записывается.If value is null, nothing is written to the text stream.

Возвраты

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Исключения

Удалено средство записи текста.The text writer is disposed.

Средство записи текста в настоящее время используется предыдущей операцией записи.The text writer is currently in use by a previous write operation.

Комментарии

Класс TextWriter является абстрактным.The TextWriter class is an abstract class. Следовательно, в коде экземпляр этого объекта не создается.Therefore, you do not instantiate it in your code. Пример использования WriteAsync метода см. в StreamWriter.WriteAsync описании метода.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Дополнительно

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

Выполняет асинхронную запись массива символов в текстовый поток.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

Параметры

buffer
Char[]

Массив символов, записываемый в текстовый поток.The character array to write to the text stream. Если buffer имеет значение null, запись не выполняется.If buffer is null, nothing is written.

Возвраты

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Исключения

Удалено средство записи текста.The text writer is disposed.

Средство записи текста в настоящее время используется предыдущей операцией записи.The text writer is currently in use by a previous write operation.

Дополнительно

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Выполняет асинхронную запись символа в текстовый поток.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

Параметры

value
Char Char Char Char

Символ, записываемый в текстовый поток.The character to write to the text stream.

Возвраты

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Исключения

Удалено средство записи текста.The text writer is disposed.

Средство записи текста в настоящее время используется предыдущей операцией записи.The text writer is currently in use by a previous write operation.

Комментарии

Класс TextWriter является абстрактным.The TextWriter class is an abstract class. Следовательно, в коде экземпляр этого объекта не создается.Therefore, you do not instantiate it in your code. Пример использования WriteAsync метода см. в StreamWriter.WriteAsync описании метода.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Дополнительно

Применяется к