TextWriter.WriteAsync Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет асинхронную запись данных в текстовый поток.
WriteAsync(Char[], Int32, Int32) |
Асинхронно записывает подмассив символов в текстовый поток. |
WriteAsync(StringBuilder, CancellationToken) |
Асинхронно записывает построитель строки в текстовый поток. |
WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Выполняет асинхронную запись области памяти символов в текстовый поток. |
WriteAsync(String) |
Выполняет асинхронную запись строки в текстовый поток. |
WriteAsync(Char[]) |
Выполняет асинхронную запись массива символов в текстовый поток. |
WriteAsync(Char) |
Выполняет асинхронную запись символа в текстовый поток. |
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Асинхронно записывает подмассив символов в текстовый поток.
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.Task
Public Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task
Параметры
- buffer
- Char[]
Массив символов, из которого записываются данные.
- index
- Int32
Положение символа в буфере, с которого начинается извлечение данных.
- count
- Int32
Количество символов для записи.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
buffer
имеет значение null
.
Сумма значений параметров index
и count
превышает длину буфера.
index
или count
является отрицательным значением.
Удалено средство записи текста.
Средство записи текста в настоящее время используется предыдущей операцией записи.
Комментарии
Класс TextWriter представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования WriteAsync метода см. в StreamWriter.WriteAsync разделе метод .
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(Char[], Int32, Int32).
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Асинхронно записывает построитель строки в текстовый поток.
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
Параметры
- value
- StringBuilder
Строка как построитель строки для записи в текстовый поток.
- cancellationToken
- CancellationToken
Токен для отслеживания запросов отмены. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
Исключения
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Этот метод эквивалентен вызову WriteAsync(stringBuilder.ToString())
, однако он использует StringBuilder.GetChunks() метод , чтобы избежать создания промежуточной строки.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(StringBuilder).
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Выполняет асинхронную запись области памяти символов в текстовый поток.
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
Параметры
- buffer
- ReadOnlyMemory<Char>
Область памяти символов для записи в текстовый поток.
- cancellationToken
- CancellationToken
Токен для отслеживания запросов отмены. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
Исключения
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Standard | 2.1 |
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Выполняет асинхронную запись строки в текстовый поток.
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.Task
Public Overridable Function WriteAsync (value As String) As Task
Параметры
- value
- String
Строка для записи. Если параметр value
имеет значение null
, в текстовый поток ничего не записывается.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
Удалено средство записи текста.
Средство записи текста в настоящее время используется предыдущей операцией записи.
Комментарии
Класс TextWriter представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования WriteAsync метода см. в StreamWriter.WriteAsync разделе метод .
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(String).
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Выполняет асинхронную запись массива символов в текстовый поток.
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.Task
Public Function WriteAsync (buffer As Char()) As Task
Параметры
- buffer
- Char[]
Массив символов, записываемый в текстовый поток. Если buffer
имеет значение null
, запись не выполняется.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
Удалено средство записи текста.
Средство записи текста в настоящее время используется предыдущей операцией записи.
Комментарии
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(Char[]).
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
- Исходный код:
- TextWriter.cs
Выполняет асинхронную запись символа в текстовый поток.
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.Task
Public Overridable Function WriteAsync (value As Char) As Task
Параметры
- value
- Char
Символ, записываемый в текстовый поток.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
Удалено средство записи текста.
Средство записи текста в настоящее время используется предыдущей операцией записи.
Комментарии
Класс TextWriter представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования WriteAsync метода см. в StreamWriter.WriteAsync разделе метод .
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(Char).
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |