File.AppendAllTextAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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)异常。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈