File.WriteAllLinesAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken) |
非同步建立新檔案，寫入指定的行數，然後關閉該檔案。 |
| WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken) |
非同步建立新檔案，使用指定的編碼寫入指定的行，然後關閉檔案。 |
WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
非同步建立新檔案，寫入指定的行數，然後關閉該檔案。
public static System.Threading.Tasks.Task WriteAllLinesAsync(string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);static member WriteAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task參數
- path
- String
要寫入的檔案。
- contents
- IEnumerable<String>
要寫入檔案的行。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表非同步寫入操作的任務。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteAllLines(String, IEnumerable<String>)拋出的例外。
適用於
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
非同步建立新檔案，使用指定的編碼寫入指定的行，然後關閉檔案。
public static System.Threading.Tasks.Task WriteAllLinesAsync(string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);static member WriteAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function WriteAllLinesAsync (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。
傳回
一個代表非同步寫入操作的任務。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteAllLines(String, IEnumerable<String>, Encoding)拋出的例外。
