TextWriter.WriteLineAsync 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

以异步形式将数据写入文本流，后跟行终止符。

重载

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	以异步形式将字符内存区域的文本表示形式写入文本流，后跟行终止符。
WriteLineAsync(String)	以异步形式将字符串写入文本流，后跟行终止符。
WriteLineAsync(Char[])	以异步形式将字符数组写入文本流，后跟行终止符。
WriteLineAsync(Char[], Int32, Int32)	以异步形式将字符子数组写入文本流，后跟行终止符。
WriteLineAsync()	以异步形式将行终止符写入文本流。
WriteLineAsync(StringBuilder, CancellationToken)	以异步形式将字符串生成器的文本表示形式写入文本流，后跟行终止符。
WriteLineAsync(Char)	以异步形式将字符写入文本流，后跟行终止符。

注解

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 WriteLineAsync 方法的示例，请参阅 StreamWriter.WriteLineAsync 方法。

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:

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)

Source:

TextWriter.cs

以异步形式将字符串写入文本流，后跟行终止符。

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);

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

Public Overridable Function WriteLineAsync (value As String) As Task

参数

value

String

要写入的字符串。 如果值为 null，则只写入行终止符。

返回

Task

表示异步写入操作的任务。

例外

ObjectDisposedException

文本编写器已被释放。

InvalidOperationException

文本编写器正在由其前一次写操作使用。

注解

行终止符由 CoreNewLine 字段定义。

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 WriteLineAsync 方法的示例，请参阅 StreamWriter.WriteLineAsync 方法。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteLine(String)异常。

另请参阅

• WriteLineAsync(String)
• WriteLineAsync(String)

WriteLineAsync(Char[])

Source:

TextWriter.cs

以异步形式将字符数组写入文本流，后跟行终止符。

public:
 System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteLineAsync (char[]? buffer);

member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteLineAsync (buffer As Char()) As Task

参数

buffer

Char[]

要写入文本流中的字符数组。 如果字符数组为 null，则仅写入行结束符。

返回

Task

表示异步写入操作的任务。

例外

ObjectDisposedException

文本编写器已被释放。

InvalidOperationException

文本编写器正在由其前一次写操作使用。

注解

行终止符由 CoreNewLine 字段定义。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteLine(Char[])异常。

另请参阅

• StreamWriter
• StringWriter

WriteLineAsync(Char[], Int32, Int32)

Source:

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);

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

表示异步写入操作的任务。

例外

ArgumentNullException

buffer 为 null。

ArgumentException

index 加 count 大于缓冲区长度。

ArgumentOutOfRangeException

index 或 count 为负数。

ObjectDisposedException

文本编写器已被释放。

InvalidOperationException

文本编写器正在由其前一次写操作使用。

注解

行终止符由 CoreNewLine 字段定义。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteLine(Char[], Int32, Int32)异常。

另请参阅

• WriteLineAsync(Char[], Int32, Int32)
• WriteLineAsync(Char[], Int32, Int32)

WriteLineAsync()

Source:

TextWriter.cs

以异步形式将行终止符写入文本流。

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync();

public virtual System.Threading.Tasks.Task WriteLineAsync ();

abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync () As Task

返回

Task

表示异步写入操作的任务。

例外

ObjectDisposedException

文本编写器已被释放。

InvalidOperationException

文本编写器正在由其前一次写操作使用。

注解

行终止符由 CoreNewLine 字段定义。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteLine()异常。

另请参阅

• WriteLineAsync()

WriteLineAsync(StringBuilder, CancellationToken)

Source:

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)

Source:

TextWriter.cs

以异步形式将字符写入文本流，后跟行终止符。

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(char value);

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

Public Overridable Function WriteLineAsync (value As Char) As Task

参数

value

Char

要写入文本流中的字符。

返回

Task

表示异步写入操作的任务。

例外

ObjectDisposedException

文本编写器已被释放。

InvalidOperationException

文本编写器正在由其前一次写操作使用。

注解

行终止符由 CoreNewLine 字段定义。

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 WriteLineAsync 方法的示例，请参阅 StreamWriter.WriteLineAsync 方法。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 WriteLine(Char)异常。

另请参阅

• WriteLineAsync(Char)
• WriteLineAsync(Char)