File.AppendAllTextAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

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

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

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