StringWriter.WriteLineAsync Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно записывает в строку данные, за которыми следует знак конца строки.
| WriteLineAsync(StringBuilder, CancellationToken) |
Асинхронно записывает строковое представление построителя строки в текущую строку, за которой следует знак конца строки. |
| WriteLineAsync(Char) |
Асинхронно записывает в строку символ, за которым следует знак конца строки. |
| WriteLineAsync(String) |
Асинхронно записывает строку в текущую строку, за которой следует знак конца строки. |
| WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) |
Асинхронно записывает строковое представление области памяти символов в текущую строку, за которой следует знак конца строки. |
| WriteLineAsync(Char[], Int32, Int32) |
Асинхронно записывает в строку дочерний массив символов, за которыми следует знак конца строки. |
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
Асинхронно записывает строковое представление построителя строки в текущую строку, за которой следует знак конца строки.
public override System.Threading.Tasks.Task WriteLineAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- value
- StringBuilder
Построитель строки для записи в поток.
- cancellationToken
- CancellationToken
Токен для отслеживания запросов отмены. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
Исключения
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine(StringBuilder).
Применяется к
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
Асинхронно записывает в строку символ, за которым следует знак конца строки.
public:
override System::Threading::Tasks::Task ^ WriteLineAsync(char value);public override System.Threading.Tasks.Task WriteLineAsync (char value);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (char value);override this.WriteLineAsync : char -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : char -> System.Threading.Tasks.TaskPublic Overrides Function WriteLineAsync (value As Char) As TaskПараметры
- value
- Char
Символ, записываемый в строку.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
Модуль записи строк удален.
Модуль записи строк сейчас используется предыдущей операцией записи.
Примеры
В следующем примере показано, как записать символы с помощью WriteLineAsync(Char) метода .
using System;
using System.Text;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
WriteCharacters();
}
static async void WriteCharacters()
{
StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
stringToWrite.AppendLine();
using (StringWriter writer = new StringWriter(stringToWrite))
{
UnicodeEncoding ue = new UnicodeEncoding();
char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));
foreach (char c in charsToAdd)
{
await writer.WriteLineAsync(c);
}
Console.WriteLine(stringToWrite.ToString());
}
}
}
}
// The example displays the following output:
//
// Characters in StringBuilder
// a
// n
// d
//
// c
// h
// a
// r
// s
//
// t
// o
//
// a
// d
// d
//
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
WriteCharacters()
End Sub
Async Sub WriteCharacters()
Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
stringToWrite.AppendLine()
Using writer As StringWriter = New StringWriter(stringToWrite)
Dim ue As UnicodeEncoding = New UnicodeEncoding()
Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
For Each c As Char In charsToAdd
Await writer.WriteLineAsync(c)
Next
Console.WriteLine(stringToWrite.ToString())
End Using
End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' a
' n
' d
'
' c
' h
' a
' r
' s
'
' t
' o
'
' a
' d
' d
'
Комментарии
Признак конца строки определяется свойством NewLine .
Применяется к
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
Асинхронно записывает строку в текущую строку, за которой следует знак конца строки.
public:
override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);public override System.Threading.Tasks.Task WriteLineAsync (string value);public override System.Threading.Tasks.Task WriteLineAsync (string? value);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (string value);override this.WriteLineAsync : string -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : string -> System.Threading.Tasks.TaskPublic Overrides Function WriteLineAsync (value As String) As TaskПараметры
- value
- String
Строка для записи. Если значение равно null, записывается только знак конца строки.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
Модуль записи строк удален.
Модуль записи строк сейчас используется предыдущей операцией записи.
Примеры
В следующем примере показано, как записать строку с помощью WriteLineAsync(String) метода .
using System;
using System.Text;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
WriteCharacters();
}
static async void WriteCharacters()
{
StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
stringToWrite.AppendLine();
using (StringWriter writer = new StringWriter(stringToWrite))
{
await writer.WriteLineAsync("and add characters through StringWriter");
Console.WriteLine(stringToWrite.ToString());
}
}
}
}
// The example displays the following output:
//
// Characters in StringBuilder
// and add characters through StringWriter
//
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
WriteCharacters()
End Sub
Async Sub WriteCharacters()
Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
stringToWrite.AppendLine()
Using writer As StringWriter = New StringWriter(stringToWrite)
Await writer.WriteLineAsync("and add characters through StringWriter")
Console.WriteLine(stringToWrite.ToString())
End Using
End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and add characters through StringWriter
'
Комментарии
Признак конца строки определяется свойством NewLine .
Применяется к
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
Асинхронно записывает строковое представление области памяти символов в текущую строку, за которой следует знак конца строки.
public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- buffer
- ReadOnlyMemory<Char>
Область памяти символов для записи в строку.
- cancellationToken
- CancellationToken
Токен для отслеживания запросов отмены. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
Исключения
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Применяется к
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
- Исходный код:
- StringWriter.cs
Асинхронно записывает в строку дочерний массив символов, за которыми следует знак конца строки.
public:
override System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.TaskPublic Overrides Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As TaskПараметры
- buffer
- Char[]
Массив символов, из которого записываются данные.
- index
- Int32
Позиция в буфере, с которой начинается чтение данных.
- count
- Int32
Наибольшее количество символов для записи.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
- Атрибуты
Исключения
buffer имеет значение null.
Сумма значений параметров index и count превышает длину буфера.
index или count является отрицательным значением.
Модуль записи строк удален.
Модуль записи строк сейчас используется предыдущей операцией записи.
Примеры
В следующем примере показано, как записать символы с помощью WriteLineAsync(Char[], Int32, Int32) метода .
using System;
using System.Text;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
WriteCharacters();
}
static async void WriteCharacters()
{
StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
stringToWrite.AppendLine();
using (StringWriter writer = new StringWriter(stringToWrite))
{
UnicodeEncoding ue = new UnicodeEncoding();
char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));
await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length);
Console.WriteLine(stringToWrite.ToString());
}
}
}
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
WriteCharacters()
End Sub
Async Sub WriteCharacters()
Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
stringToWrite.AppendLine()
Using writer As StringWriter = New StringWriter(stringToWrite)
Dim ue As UnicodeEncoding = New UnicodeEncoding()
Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
Await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length)
Console.WriteLine(stringToWrite.ToString())
End Using
End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and chars to add
'
Комментарии
Признак конца строки определяется свойством NewLine .
