Freigeben über

TextReader.ReadLineAsync Methode

Definition

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

Überlädt

Name Beschreibung
ReadLineAsync()

Liest asynchron eine Zeichenzeile und gibt die Daten als Zeichenfolge zurück.
ReadLineAsync(CancellationToken)

Liest asynchron eine Zeichenzeile und gibt die Daten als Zeichenfolge zurück.

ReadLineAsync()

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

Liest asynchron eine Zeichenzeile 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 der Textsprachausgabe oder ob null alle Zeichen gelesen wurden.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentOutOfRangeException

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

ObjectDisposedException

Die Textsprachausgabe wurde gelöscht.

InvalidOperationException

Der Leser wird derzeit 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 unter 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 Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadLine().

Weitere Informationen

Gilt für:

ReadLineAsync(CancellationToken)

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

Liest asynchron eine Zeichenzeile 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, das auf Abbruchanforderungen überwacht werden soll.

Gibt zurück

ValueTask<String>

Eine Wertaufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult Parameters enthält die nächste Zeile der Textsprachausgabe oder ob null alle Zeichen gelesen wurden.

Ausnahmen

ArgumentOutOfRangeException

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

ObjectDisposedException

Die Textsprachausgabe wurde gelöscht.

InvalidOperationException

Der Leser wird derzeit 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 unter 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 Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadLine().

Gilt für: