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