File.ReadLinesAsync Método

Definição

Sobrecargas

Name Description
ReadLinesAsync(String, CancellationToken)

Lê assíncronamente as linhas de um ficheiro.

ReadLinesAsync(String, Encoding, CancellationToken)

Lê assíncronamente as linhas de um ficheiro que tem uma codificação especificada.

ReadLinesAsync(String, CancellationToken)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Lê assíncronamente as linhas de um ficheiro.

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)

Parâmetros

path
String

O ficheiro para ler.

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento. O valor predefinido é None.

Devoluções

O enumerável assíncrono que representa todas as linhas do ficheiro, ou as linhas que resultam de uma consulta.

Exceções

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ReadLines(String).

Aplica-se a

ReadLinesAsync(String, Encoding, CancellationToken)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Lê assíncronamente as linhas de um ficheiro que tem uma codificação especificada.

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)

Parâmetros

path
String

O ficheiro para ler.

encoding
Encoding

A codificação que é aplicada ao conteúdo do ficheiro.

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento. O valor predefinido é None.

Devoluções

O enumerável assíncrono que representa todas as linhas do ficheiro, ou as linhas que resultam de uma consulta.

Exceções

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ReadLines(String, Encoding).

Aplica-se a