TextReader.ReadLineAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
ReadLineAsync()	Načte řádek znaků asynchronně a vrátí data jako řetězec.
ReadLineAsync(CancellationToken)	Načte řádek znaků asynchronně a vrátí data jako řetězec.

ReadLineAsync()

Zdroj:

TextReader.cs

Načte řádek znaků asynchronně a vrátí data jako řetězec.

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();

public virtual System.Threading.Tasks.Task<string?> ReadLineAsync();

abstract member ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>

Public Overridable Function ReadLineAsync () As Task(Of String)

Návraty

Task<String>

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek od čtečky textu, nebo pokud null byly přečtené všechny znaky.

Výjimky

ArgumentOutOfRangeException

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

ObjectDisposedException

Čtečka textu byla odstraněna.

InvalidOperationException

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

Poznámky

Třída TextReader je abstraktní třída. Proto ji v kódu neodstraňujete. Příklad použití ReadLineAsync metody najdete v StreamReader.ReadLineAsync metodě.

Pokud aktuální TextReader představuje standardní vstupní datový proud vrácený Console.In vlastností, ReadLineAsync metoda provádí synchronně místo asynchronně.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadLine().

Viz také

• ReadLineAsync()
• ReadLineAsync()
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

ReadLineAsync(CancellationToken)

Zdroj:

TextReader.cs

Načte řádek znaků asynchronně a vrátí data jako řetězec.

public:
 virtual System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.ValueTask<string?> ReadLineAsync(System.Threading.CancellationToken cancellationToken);

abstract member ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>

Public Overridable Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)

Parametry

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

ValueTask<String>

Hodnota úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek od čtečky textu, nebo pokud null byly přečtené všechny znaky.

Výjimky

ArgumentOutOfRangeException

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

ObjectDisposedException

Čtečka textu byla odstraněna.

InvalidOperationException

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

OperationCanceledException

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

Poznámky

Třída TextReader je abstraktní třída. Proto ji v kódu neodstraňujete. Příklad použití ReadLineAsync(CancellationToken) metody najdete v ReadLineAsync(CancellationToken) metodě.

Pokud aktuální TextReader představuje standardní vstupní datový proud vrácený Console.In vlastností, ReadLineAsync(CancellationToken) metoda provádí synchronně místo asynchronně.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadLine().