Udostępnij za pośrednictwem


TextReader.ReadLineAsync Metoda

Definicja

Przeciążenia

ReadLineAsync()

Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg.

ReadLineAsync(CancellationToken)

Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg.

ReadLineAsync()

Źródło:
TextReader.cs
Źródło:
TextReader.cs
Źródło:
TextReader.cs

Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg.

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)

Zwraca

Zadanie reprezentujące operację odczytu asynchronicznego. Wartość parametru TResult zawiera następny wiersz z czytnika tekstu lub określa null , czy wszystkie znaki zostały odczytane.

Atrybuty

Wyjątki

Liczba znaków w następnym wierszu jest większa niż Int32.MaxValue.

Czytnik tekstu został usunięty.

Czytelnik jest obecnie używany przez poprzednią operację odczytu.

Uwagi

Klasa TextReader jest klasą abstrakcyjną. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia ReadLineAsync metody, zobacz metodę StreamReader.ReadLineAsync .

Jeśli bieżący TextReader reprezentuje standardowy strumień wejściowy zwrócony przez Console.In właściwość, metoda wykonuje synchronicznie, ReadLineAsync a nie asynchronicznie.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez ReadLine()usługę .

Zobacz też

Dotyczy

ReadLineAsync(CancellationToken)

Źródło:
TextReader.cs
Źródło:
TextReader.cs
Źródło:
TextReader.cs

Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg.

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 do monitorowania żądań anulowania.

Zwraca

Zadanie wartości reprezentujące operację odczytu asynchronicznego. Wartość parametru TResult zawiera następny wiersz z czytnika tekstu lub określa null , czy wszystkie znaki zostały odczytane.

Wyjątki

Liczba znaków w następnym wierszu jest większa niż Int32.MaxValue.

Czytnik tekstu został usunięty.

Czytelnik jest obecnie używany przez poprzednią operację odczytu.

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Klasa TextReader jest klasą abstrakcyjną. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia ReadLineAsync(CancellationToken) metody, zobacz metodę ReadLineAsync(CancellationToken) .

Jeśli bieżący TextReader reprezentuje standardowy strumień wejściowy zwrócony przez Console.In właściwość, metoda wykonuje synchronicznie, ReadLineAsync(CancellationToken) a nie asynchronicznie.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez ReadLine()usługę .

Dotyczy