File.AppendAllTextAsync 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

AppendAllTextAsync(String, String, Encoding, CancellationToken)	异步打开文件或创建文件（如果该文件尚不存在），使用指定的编码将指定的字符串追加到该文件，然后关闭该文件。
AppendAllTextAsync(String, String, CancellationToken)	异步打开文件或创建文件（如果该文件尚不存在），将指定的字符串追加到该文件，然后关闭该文件。

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Source:

File.cs

异步打开文件或创建文件（如果该文件尚不存在），使用指定的编码将指定的字符串追加到该文件，然后关闭该文件。

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function AppendAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

path

String

要向其追加指定字符串的文件。

contents

String

要追加到文件的字符串。

encoding

Encoding

要使用的字符编码。

cancellationToken

CancellationToken

用于监视取消请求的令牌。 默认值为 None。

返回

Task

表示异步追加操作的任务。

例外

OperationCanceledException

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

注解

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

AppendAllTextAsync(String, String, CancellationToken)

Source:

File.cs

异步打开文件或创建文件（如果该文件尚不存在），将指定的字符串追加到该文件，然后关闭该文件。

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function AppendAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

path

String

要向其追加指定字符串的文件。

contents

String

要追加到文件的字符串。

cancellationToken

CancellationToken

用于监视取消请求的令牌。 默认值为 None。

返回

Task

表示异步追加操作的任务。

例外

OperationCanceledException

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

注解

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