TextWriter.WriteAsync 方法

定义

将数据异步写入文本流。

重载

WriteAsync(Char[], Int32, Int32)

以异步形式将字符的子数组写入文本流。

WriteAsync(StringBuilder, CancellationToken)

以异步形式将字符串生成器写入文本流。

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

以异步形式将字符内存区域写入文本流。

WriteAsync(String)

将字符串异步写入文本流。

WriteAsync(Char[])

将字符数组异步写入文本流。

WriteAsync(Char)

将字符异步写入文本流。

WriteAsync(Char[], Int32, Int32)

以异步形式将字符的子数组写入文本流。

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

要写入的字符数。

返回

Task

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

属性

例外

buffernull

indexcount 大于缓冲区长度。

indexcount 为负数。

文本编写器已被释放。

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

注解

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

另请参阅

适用于

WriteAsync(StringBuilder, CancellationToken)

以异步形式将字符串生成器写入文本流。

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

返回

Task

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

注解

但是,此方法等效于调用 WriteAsync(stringBuilder.ToString()),但它使用 StringBuilder.GetChunks() 该方法避免创建中间字符串。

适用于

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

以异步形式将字符内存区域写入文本流。

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

返回

Task

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

适用于

WriteAsync(String)

将字符串异步写入文本流。

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

要写入的字符串。 如果 valuenull,则不会将任何内容写入文本流。

返回

Task

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

属性

例外

文本编写器已被释放。

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

注解

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

另请参阅

适用于

WriteAsync(Char[])

将字符数组异步写入文本流。

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[]

要写入文本流中的字符数组。 如果 buffernull,则不写入任何内容。

返回

Task

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

属性

例外

文本编写器已被释放。

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

另请参阅

适用于

WriteAsync(Char)

将字符异步写入文本流。

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

要写入文本流中的字符。

返回

Task

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

属性

例外

文本编写器已被释放。

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

注解

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

另请参阅

适用于