TextWriter.WriteLineAsync Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.Runtime.dll
Сборка:
System.Runtime.Extensions.dll
Сборка:
netstandard.dll
Сборка:
System.IO.dll
Сборка:
mscorlib.dll

Асинхронно записывает в текстовый поток данные, за которыми следует признак конца строки.

Перегрузки

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Асинхронно записывает в текстовый поток текстовое представление области памяти символов, за которым следует знак конца строки.
WriteLineAsync(String)

Асинхронно записывает в текстовый поток строку, за которой следует признак конца строки.
WriteLineAsync(Char[])

Асинхронно записывает в текстовый поток массив символов, за которым следует признак конца строки.
WriteLineAsync(Char[], Int32, Int32)

Асинхронно записывает в текстовый поток подмассив символов, за которым следует признак конца строки.
WriteLineAsync()

Асинхронно записывает признак конца строки в текстовый поток.
WriteLineAsync(StringBuilder, CancellationToken)

Асинхронно записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки.
WriteLineAsync(Char)

Асинхронно записывает в текстовый поток символ, за которым следует признак конца строки.

Комментарии

Класс TextWriter представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования метода см. в WriteLineAsync этом методе StreamWriter.WriteLineAsync .

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает в текстовый поток текстовое представление области памяти символов, за которым следует знак конца строки.

public virtual System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
abstract member WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Параметры

buffer
ReadOnlyMemory<Char>

Область памяти символов для записи в текстовый поток.

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Признак конца строки определяется полем CoreNewLine .

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

WriteLineAsync(String)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает в текстовый поток строку, за которой следует признак конца строки.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);
public virtual System.Threading.Tasks.Task WriteLineAsync (string value);
public virtual System.Threading.Tasks.Task WriteLineAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync (string value);
abstract member WriteLineAsync : string -> System.Threading.Tasks.Task
override this.WriteLineAsync : string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : string -> System.Threading.Tasks.Task
override this.WriteLineAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As String) As Task

Параметры

value
String

Строка для записи. Если значение равно null, записывается только знак конца строки.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Атрибуты
ComVisibleAttribute

Исключения

ObjectDisposedException

Удалено средство записи текста.

InvalidOperationException

Средство записи текста в настоящее время используется предыдущей операцией записи.

Комментарии

Признак конца строки определяется полем CoreNewLine .

Класс TextWriter представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования WriteLineAsync метода см. в StreamWriter.WriteLineAsync разделе метод .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine(String).

См. также раздел

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

WriteLineAsync(Char[])

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает в текстовый поток массив символов, за которым следует признак конца строки.

public:
 System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer);
public System.Threading.Tasks.Task WriteLineAsync (char[] buffer);
public System.Threading.Tasks.Task WriteLineAsync (char[]? buffer);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteLineAsync (char[] buffer);
member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task
Public Function WriteLineAsync (buffer As Char()) As Task

Параметры

buffer
Char[]

Массив символов, записываемый в текстовый поток. Если массив символов имеет значение null, записывается только признак конца строки.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Атрибуты
ComVisibleAttribute

Исключения

ObjectDisposedException

Удалено средство записи текста.

InvalidOperationException

Средство записи текста в настоящее время используется предыдущей операцией записи.

Комментарии

Признак конца строки определяется полем CoreNewLine .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine(Char[]).

См. также раздел

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

WriteLineAsync(Char[], Int32, Int32)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает в текстовый поток подмассив символов, за которым следует признак конца строки.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);
abstract member WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

Параметры

buffer
Char[]

Массив символов, из которого записываются данные.

index
Int32

Положение символа в буфере, с которого начинается извлечение данных.

count
Int32

Количество символов для записи.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Атрибуты
ComVisibleAttribute

Исключения

ArgumentNullException

buffer имеет значение null.

ArgumentException

Сумма значений параметров index и count превышает длину буфера.

ArgumentOutOfRangeException

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

ObjectDisposedException

Удалено средство записи текста.

InvalidOperationException

Средство записи текста в настоящее время используется предыдущей операцией записи.

Комментарии

Признак конца строки определяется полем CoreNewLine .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine(Char[], Int32, Int32).

См. также раздел

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

WriteLineAsync()

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает признак конца строки в текстовый поток.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync();
public virtual System.Threading.Tasks.Task WriteLineAsync ();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync ();
abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync () As Task

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Атрибуты
ComVisibleAttribute

Исключения

ObjectDisposedException

Удалено средство записи текста.

InvalidOperationException

Средство записи текста в настоящее время используется предыдущей операцией записи.

Комментарии

Признак конца строки определяется полем CoreNewLine .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine().

См. также раздел

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

WriteLineAsync(StringBuilder, CancellationToken)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает в текстовый поток текстовое представление построителя строки, за которым следует знак конца строки.

public virtual System.Threading.Tasks.Task WriteLineAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);
abstract member WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Параметры

value
StringBuilder

Строка как построитель строки для записи в текстовый поток.

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Признак конца строки определяется полем CoreNewLine .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine(StringBuilder).

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

WriteLineAsync(Char)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs

Асинхронно записывает в текстовый поток символ, за которым следует признак конца строки.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(char value);
public virtual System.Threading.Tasks.Task WriteLineAsync (char value);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync (char value);
abstract member WriteLineAsync : char -> System.Threading.Tasks.Task
override this.WriteLineAsync : char -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : char -> System.Threading.Tasks.Task
override this.WriteLineAsync : char -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As Char) As Task

Параметры

value
Char

Символ, записываемый в текстовый поток.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Атрибуты
ComVisibleAttribute

Исключения

ObjectDisposedException

Удалено средство записи текста.

InvalidOperationException

Средство записи текста в настоящее время используется предыдущей операцией записи.

Комментарии

Признак конца строки определяется полем CoreNewLine .

Класс TextWriter представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования WriteLineAsync метода см. в StreamWriter.WriteLineAsync разделе метод .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteLine(Char).

См. также раздел

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