TextReader.ReadLineAsync Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Überlädt

ReadLineAsync()

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.
ReadLineAsync(CancellationToken)

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.

ReadLineAsync()

Quelle:
TextReader.cs
Quelle:
TextReader.cs
Quelle:
TextReader.cs

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.

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)

Gibt zurück

Task<String>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult-Parameters enthält die nächste Zeile aus dem Textreader oder null, wenn alle Zeichen gelesen wurden.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentOutOfRangeException

Die Anzahl der Zeichen in der nächsten Zeile ist größer als Int32.MaxValue.

ObjectDisposedException

Der Textreader wurde freigegeben.

InvalidOperationException

Der Reader wird zurzeit von einem vorherigen Lesevorgang verwendet.

Hinweise

Die TextReader-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Ein Beispiel für die Verwendung der ReadLineAsync -Methode finden Sie in der StreamReader.ReadLineAsync -Methode.

Wenn der aktuelle TextReader den von der Console.In -Eigenschaft zurückgegebenen Standardeingabedatenstrom darstellt, wird die ReadLineAsync -Methode synchron und nicht asynchron ausgeführt.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden ReadLine().

Weitere Informationen

Gilt für:

ReadLineAsync(CancellationToken)

Quelle:
TextReader.cs
Quelle:
TextReader.cs
Quelle:
TextReader.cs

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.

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)

Parameter

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

ValueTask<String>

Ein Werttask, der den asynchronen Lesevorgang darstellt Der Wert des TResult-Parameters enthält die nächste Zeile aus dem Textreader oder null, wenn alle Zeichen gelesen wurden.

Ausnahmen

ArgumentOutOfRangeException

Die Anzahl der Zeichen in der nächsten Zeile ist größer als Int32.MaxValue.

ObjectDisposedException

Der Textreader wurde freigegeben.

InvalidOperationException

Der Reader wird zurzeit von einem vorherigen Lesevorgang verwendet.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Die TextReader-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Ein Beispiel für die Verwendung der ReadLineAsync(CancellationToken) -Methode finden Sie in der ReadLineAsync(CancellationToken) -Methode.

Wenn der aktuelle TextReader den von der Console.In -Eigenschaft zurückgegebenen Standardeingabedatenstrom darstellt, wird die ReadLineAsync(CancellationToken) -Methode synchron und nicht asynchron ausgeführt.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden ReadLine().

Gilt für: