TextReader.ReadLineAsync Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Přetížení

ReadLineAsync()

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

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

ReadLineAsync()

Zdroj:
TextReader.cs
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs

Přeč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 ();
public virtual System.Threading.Tasks.Task<string?> ReadLineAsync ();
[System.Runtime.InteropServices.ComVisible(false)]
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>
[<System.Runtime.InteropServices.ComVisible(false)>]
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 čtenáře textu nebo je null , pokud byly přečtené všechny znaky.

Atributy
ComVisibleAttribute

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 nevytvořujete. Příklad použití ReadLineAsync metody najdete v StreamReader.ReadLineAsync metodě .

Pokud aktuální TextReader představuje standardní vstupní stream vrácený Console.In vlastností, ReadLineAsync metoda se spouští synchronně, nikoli asynchronně.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadLine().

Viz také

Platí pro

ReadLineAsync(CancellationToken)

Zdroj:
TextReader.cs
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs

Přeč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, který se má monitorovat pro žádosti o zrušení.

Návraty

ValueTask<String>

Úloha hodnoty, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek od čtenáře textu nebo je null , pokud 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 ve vrácené úloze.

Poznámky

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

Pokud aktuální TextReader představuje standardní vstupní stream vrácený Console.In vlastností, ReadLineAsync(CancellationToken) metoda se spouští synchronně, nikoli asynchronně.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadLine().

Platí pro