StreamReader.ReadLineAsync Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.IO.dll
Assemblagem:
netstandard.dll

Lê uma linha de caracteres de forma assíncrona a partir do fluxo atual e devolve os dados como uma cadeia.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();
public override System.Threading.Tasks.Task<string> ReadLineAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadLineAsync();
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
Public Overrides Function ReadLineAsync () As Task(Of String)

Devoluções

Task<String>

Uma tarefa que representa a operação de leitura assíncrona. O valor do TResult parâmetro contém a linha seguinte do fluxo, ou é null se todos os caracteres foram lidos.

Atributos
ComVisibleAttribute

Exceções

ArgumentOutOfRangeException

O número de caracteres na linha seguinte é maior do que o Int32.MaxValue.

ObjectDisposedException

O riacho foi eliminado.

InvalidOperationException

O leitor está atualmente em uso por uma operação de leitura anterior.

Exemplos

O exemplo seguinte mostra como ler a primeira linha de um ficheiro usando o ReadLineAsync() método.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static async Task Main()
        {
            await ReadCharacters();
        }

        static async Task ReadCharacters()
        {
            String result;
            using (StreamReader reader = File.OpenText("existingfile.txt"))
            {
                Console.WriteLine("Opened file.");
                result = await reader.ReadLineAsync();
                Console.WriteLine("First line contains: " + result);
            }
        }
    }
}

Imports System.IO

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim result As String

        Using reader As StreamReader = File.OpenText("existingfile.txt")
            Console.WriteLine("Opened file.")
            result = Await reader.ReadLineAsync()
            Console.WriteLine("First line contains: " + result)
        End Using
    End Sub
End Module

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 ReadLine().

Aplica-se a