File.AppendAllTextAsync 方法

定義

命名空間:: System.IO

組件:: netstandard.dll, System.Runtime.dll

組件:: netstandard.dll, System.IO.FileSystem.dll

組件:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

組件:: System.IO.FileSystem.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

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

AppendAllTextAsync(String, String, Encoding, CancellationToken)

來源:: File.cs

來源:: File.cs

來源:: File.cs

來源:: File.cs

來源:: 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。

傳回

Task

表示異步附加作業的工作。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。使用例外錯誤，例如 ArgumentException，仍會同步拋出。關於儲存的例外，請參見由 AppendAllText(String, String, Encoding)拋出的例外。

適用於

AppendAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)

來源:: File.cs

來源:: File.cs

來源:: File.cs

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

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

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

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

參數

path: String

要附加指定字串的檔案。

contents: ReadOnlyMemory<Char>

要附加至檔案的字元。

encoding: Encoding

要使用的字元編碼。

cancellationToken: CancellationToken

用來監控取消申請的代幣。預設值為 None。

傳回

Task

表示異步附加作業的工作。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

適用於

AppendAllTextAsync(String, String, CancellationToken)

來源:: File.cs

來源:: File.cs

來源:: File.cs

來源:: File.cs

來源:: 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。

傳回

Task

表示異步附加作業的工作。

例外狀況

OperationCanceledException

取消令牌也被取消了。此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。使用例外錯誤，例如 ArgumentException，仍會同步拋出。關於儲存的例外，請參見由 AppendAllText(String, String)拋出的例外。

適用於

AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

來源:: File.cs

來源:: File.cs

來源:: File.cs

以異步方式開啟檔案，或在檔案不存在時建立檔案、將指定的字串附加至檔案，然後關閉檔案。

public static System.Threading.Tasks.Task AppendAllTextAsync(string path, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);

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

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