語言

File.AppendAllLinesAsync 方法

定義

命名空間:
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

多載

名稱 Description
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

非同步地將行附加到檔案上，然後關閉該檔案。 如果指定的檔案不存在，這個方法會建立檔案、將指定的行寫入檔案，然後關閉檔案。
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

非同步地使用指定的編碼方式將行數附加到檔案中，然後關閉該檔案。 如果指定的檔案不存在，這個方法會建立檔案、將指定的行寫入檔案，然後關閉檔案。

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs

非同步地將行附加到檔案上，然後關閉該檔案。 如果指定的檔案不存在，這個方法會建立檔案、將指定的行寫入檔案，然後關閉檔案。

public static System.Threading.Tasks.Task AppendAllLinesAsync(string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllLinesAsync (path As String, contents As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task

參數

path
String

要附加行的檔案。 如果檔案不存在，就會建立它。

contents
IEnumerable<String>

要附加至檔案的行。

cancellationToken
CancellationToken

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

傳回

Task

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

例外狀況

OperationCanceledException

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

備註

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

適用於

AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs

非同步地使用指定的編碼方式將行數附加到檔案中，然後關閉該檔案。 如果指定的檔案不存在，這個方法會建立檔案、將指定的行寫入檔案，然後關閉檔案。

public static System.Threading.Tasks.Task AppendAllLinesAsync(string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);
static member AppendAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function AppendAllLinesAsync (path As String, contents As IEnumerable(Of String), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

參數

path
String

要附加行的檔案。 如果檔案不存在，就會建立它。

contents
IEnumerable<String>

要附加至檔案的行。

encoding
Encoding

要使用的字元編碼。

cancellationToken
CancellationToken

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

傳回

Task

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

例外狀況

OperationCanceledException

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

備註

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

適用於