Auf Englisch lesen

Freigeben über


TextReader.ReadLineAsync Methode

Definition

Ü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.

C#
public virtual System.Threading.Tasks.Task<string> ReadLineAsync ();
C#
public virtual System.Threading.Tasks.Task<string?> ReadLineAsync ();
C#
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<string> ReadLineAsync ();

Gibt zurück

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

Ausnahmen

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

Der Textreader wurde freigegeben.

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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.

C#
public virtual System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);

Parameter

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

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

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

Der Textreader wurde freigegeben.

Der Reader wird zurzeit von einem vorherigen Lesevorgang verwendet.

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET 7, 8, 9