语言

TextWriter.WriteAsync 方法

定义

以异步方式将数据写入文本流。

重载

名称 说明
WriteAsync(String, CancellationToken)
WriteAsync(Char[], Int32, Int32)

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

WriteAsync(StringBuilder, CancellationToken)

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

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

WriteAsync(Char)

以异步方式将字符写入文本流。

WriteAsync(String)

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

WriteAsync(Char[])

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

WriteAsync(Rune)

WriteAsync(String, CancellationToken)

Source:
TextWriter.cs
public:
 System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteAsync(string? value, System.Threading.CancellationToken cancellationToken);
member this.WriteAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteAsync (value As String, cancellationToken As CancellationToken) As Task

参数

value
String
cancellationToken
CancellationToken

返回

适用于

WriteAsync(Char[], Int32, Int32)

Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

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

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

要写入的字符数。

返回

表示异步写入作的任务。

特性

例外

buffer 是 null。

index加号count大于缓冲区长度。

index 或 count 为负数。

将释放文本编写器。

文本编写器当前正由以前的写入作使用。

注解

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

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

另请参阅

适用于

WriteAsync(StringBuilder, CancellationToken)

Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

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

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。

返回

表示异步写入作的任务。

例外

取消令牌已取消。 此异常存储在返回的任务中。

注解

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

此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 Write(StringBuilder)..

适用于

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

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

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。

返回

表示异步写入作的任务。

例外

取消令牌已取消。 此异常存储在返回的任务中。

适用于

WriteAsync(Char)

Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

以异步方式将字符写入文本流。

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

要写入文本流的字符。

返回

表示异步写入作的任务。

特性

例外

将释放文本编写器。

文本编写器当前正由以前的写入作使用。

注解

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

此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 Write(Char)..

另请参阅

适用于

WriteAsync(String)

Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

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

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

要写入的字符串。 value如果是null,则不会向文本流写入任何内容。

返回

表示异步写入作的任务。

特性

例外

将释放文本编写器。

文本编写器当前正由以前的写入作使用。

注解

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

此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 Write(String)..

另请参阅

适用于

WriteAsync(Char[])

Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs
Source:
TextWriter.cs

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

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

要写入文本流的字符数组。 buffer如果是null,则不编写任何内容。

返回

表示异步写入作的任务。

特性

例外

将释放文本编写器。

文本编写器当前正由以前的写入作使用。

注解

此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 Write(Char[])..

另请参阅

适用于

WriteAsync(Rune)

Source:
TextWriter.cs
public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::Text::Rune value);
public virtual System.Threading.Tasks.Task WriteAsync(System.Text.Rune value);
abstract member WriteAsync : System.Text.Rune -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.Rune -> System.Threading.Tasks.Task
Public Overridable Function WriteAsync (value As Rune) As Task

参数

value
Rune

返回

适用于