File.AppendAllTextAsync 方法

定义

重载

AppendAllTextAsync(String, String, CancellationToken)

以异步方式打开文件或创建文件(如果文件尚不存在),将指定的字符串追加到该文件,然后关闭文件。

AppendAllTextAsync(String, String, Encoding, CancellationToken)

以异步方式打开文件或创建文件(如果文件尚不存在),使用指定的编码将指定的字符串追加到该文件,然后关闭文件。

AppendAllTextAsync(String, String, CancellationToken)

Source:
File.cs
Source:
File.cs
Source:
File.cs

以异步方式打开文件或创建文件(如果文件尚不存在),将指定的字符串追加到该文件,然后关闭文件。

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);
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

返回

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

例外

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

注解

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

适用于

AppendAllTextAsync(String, String, Encoding, CancellationToken)

Source:
File.cs
Source:
File.cs
Source:
File.cs

以异步方式打开文件或创建文件(如果文件尚不存在),使用指定的编码将指定的字符串追加到该文件,然后关闭文件。

public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
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

返回

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

例外

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

注解

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

适用于