TextReader.ReadLineAsync Methode

Definition

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();
[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

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

Ausnahmen

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

Die Textsprachausgabe wurde gelöscht.

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().

Gilt für:

Weitere Informationen