File.AppendAllTextAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

AppendAllTextAsync(String, String, CancellationToken)	以非同步方式開啟檔案或建立檔案 (如果檔案不存在)，並將指定的字串附加至檔案，然後關閉檔案。
AppendAllTextAsync(String, String, Encoding, CancellationToken)	以非同步方式開啟檔案或建立檔案 (如果檔案不存在)，並使用指定編碼方式將指定的字串附加至檔案，然後關閉檔案。

AppendAllTextAsync(String, String, CancellationToken)

來源:

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) 例外狀況。

AppendAllTextAsync(String, String, Encoding, CancellationToken)

來源:

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) 例外狀況。