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