TextReader.ReadLineAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
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().
Weitere Informationen
- ReadLineAsync()
- ReadLineAsync()
- Datei- und Stream-E/A
- Vorgehensweise: Lesen von Text aus einer Datei
- Vorgehensweise: Schreiben von Text in eine Datei
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
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
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.
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().
