Udostępnij za pośrednictwem

TextReader.ReadLineAsync Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.IO.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.Runtime.Extensions.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

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

Task<String>

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
ComVisibleAttribute

Wyjątki

ArgumentOutOfRangeException

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

ObjectDisposedException

Czytnik tekstu został usunięty.

InvalidOperationException

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

ValueTask<String>

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

ArgumentOutOfRangeException

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

ObjectDisposedException

Czytnik tekstu został usunięty.

InvalidOperationException

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

OperationCanceledException

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