Поделиться через

TextWriter.WriteLineAsync Метод

Определение

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

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

Перегрузки

Имя Описание
WriteLineAsync(String, CancellationToken)
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

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

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

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

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

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

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

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

Комментарии

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

WriteLineAsync(String, CancellationToken)

Исходный код:
TextWriter.cs
public:
 System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteLineAsync(string? value, System.Threading.CancellationToken cancellationToken);
member this.WriteLineAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteLineAsync (value As String, cancellationToken As CancellationToken) As Task

Параметры

value
String
cancellationToken
CancellationToken

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

Task

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

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
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(CancellationToken)

Исходный код:
TextWriter.cs
public:
 System::Threading::Tasks::Task ^ WriteLineAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteLineAsync(System.Threading.CancellationToken cancellationToken);
member this.WriteLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteLineAsync (cancellationToken As CancellationToken) As Task

Параметры

cancellationToken
CancellationToken

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

Task

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

WriteLineAsync(Rune)

Исходный код:
TextWriter.cs
public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(System::Text::Rune value);
public virtual System.Threading.Tasks.Task WriteLineAsync(System.Text.Rune value);
abstract member WriteLineAsync : System.Text.Rune -> System.Threading.Tasks.Task
override this.WriteLineAsync : System.Text.Rune -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync (value As Rune) As Task

Параметры

value
Rune

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

Task

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

WriteLineAsync(StringBuilder, CancellationToken)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
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
Исходный код:
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)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
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).

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

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

WriteLineAsync()

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
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(String)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
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[], Int32, Int32)

Исходный код:
TextWriter.cs
Исходный код:
TextWriter.cs
Исходный код:
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

count Плюс index больше длины буфера.

ArgumentOutOfRangeException

index или count отрицательный.

ObjectDisposedException

Модуль записи текста удаляется.

InvalidOperationException

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

Комментарии

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

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

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

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