TextReader.ReadLineAsync Metod

Definition

Namnområde:
System.IO
Sammansättningar:
mscorlib.dll, System.IO.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.IO.dll
Sammansättning:
System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Överlagringar

Name Description
ReadLineAsync()

Läser en rad tecken asynkront och returnerar data som en sträng.
ReadLineAsync(CancellationToken)

Läser en rad tecken asynkront och returnerar data som en sträng.

ReadLineAsync()

Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs

Läser en rad tecken asynkront och returnerar data som en sträng.

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)

Returer

Task<String>

En uppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller nästa rad från textläsaren, eller null om alla tecken har lästs.

Attribut
ComVisibleAttribute

Undantag

ArgumentOutOfRangeException

Antalet tecken på nästa rad är större än Int32.MaxValue.

ObjectDisposedException

Textläsaren har tagits bort.

InvalidOperationException

Läsaren används för närvarande av en tidigare läsåtgärd.

Kommentarer

Klassen TextReader är en abstrakt klass. Därför instansierar du den inte i koden. Ett exempel på hur du ReadLineAsync använder metoden finns i StreamReader.ReadLineAsync metoden.

Om strömmen TextReader representerar den standardindataström som returneras av Console.In egenskapen ReadLineAsync körs metoden synkront i stället för asynkront.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ReadLine().

Se även

Gäller för

ReadLineAsync(CancellationToken)

Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs

Läser en rad tecken asynkront och returnerar data som en sträng.

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)

Parametrar

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden.

Returer

ValueTask<String>

En värdeuppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller nästa rad från textläsaren, eller null om alla tecken har lästs.

Undantag

ArgumentOutOfRangeException

Antalet tecken på nästa rad är större än Int32.MaxValue.

ObjectDisposedException

Textläsaren har tagits bort.

InvalidOperationException

Läsaren används för närvarande av en tidigare läsåtgärd.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Klassen TextReader är en abstrakt klass. Därför instansierar du den inte i koden. Ett exempel på hur du ReadLineAsync(CancellationToken) använder metoden finns i ReadLineAsync(CancellationToken) metoden.

Om strömmen TextReader representerar den standardindataström som returneras av Console.In egenskapen ReadLineAsync(CancellationToken) körs metoden synkront i stället för asynkront.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ReadLine().

Gäller för