File.ReadAllLinesAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| ReadAllLinesAsync(String, CancellationToken) |
异步打开文本文件，读取文件的所有行，然后关闭该文件。 |
| ReadAllLinesAsync(String, Encoding, CancellationToken) |
异步打开文本文件，读取具有指定编码的文件的所有行，然后关闭该文件。 |
ReadAllLinesAsync(String, CancellationToken)
异步打开文本文件，读取文件的所有行，然后关闭该文件。
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)
异步打开文本文件，读取具有指定编码的文件的所有行，然后关闭该文件。
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)..