Sdílet prostřednictvím


StreamReader.ReadLineAsync Metoda

Definice

Přetížení

ReadLineAsync()

Přečte řádek znaků asynchronně z aktuálního datového proudu a vrátí data jako řetězec.

ReadLineAsync(CancellationToken)

Přečte řádek znaků asynchronně z aktuálního datového proudu a vrátí data jako řetězec.

ReadLineAsync()

Zdroj:
StreamReader.cs
Zdroj:
StreamReader.cs
Zdroj:
StreamReader.cs

Přečte řádek znaků asynchronně z aktuálního datového proudu a vrátí data jako řetězec.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();
public override System.Threading.Tasks.Task<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)

Návraty

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek z datového proudu nebo je null , pokud byly přečtené všechny znaky.

Atributy

Výjimky

Počet znaků na dalším řádku je větší než Int32.MaxValue.

Datový proud byl odstraněn.

Čtečka je aktuálně používána předchozí operací čtení.

Příklady

Následující příklad ukazuje, jak číst první řádek souboru pomocí ReadLineAsync() metody .

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadLine().

Platí pro

ReadLineAsync(CancellationToken)

Zdroj:
StreamReader.cs
Zdroj:
StreamReader.cs
Zdroj:
StreamReader.cs

Přečte řádek znaků asynchronně z aktuálního datového proudu a vrátí data jako řetězec.

public:
 override System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);
override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
Public Overrides Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)

Parametry

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Úloha s hodnotou, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek z datového proudu nebo je null , pokud byly přečtené všechny znaky.

Výjimky

Počet znaků na dalším řádku je větší než Int32.MaxValue.

Čtečka streamu byla odstraněna.

Čtečka je aktuálně používána předchozí operací čtení.

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Pokud je tato metoda zrušena prostřednictvím cancellationToken, může dojít ke ztrátě některých dat, která byla načtena z aktuálního Stream , ale nebyla uložena (pomocí StreamReader) nebo vrácena (volajícímu).

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadLine().

Platí pro