TextReader.ReadLineAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| ReadLineAsync() |
Leest asynchroon een regel tekens en retourneert de gegevens als een tekenreeks. |
| ReadLineAsync(CancellationToken) |
Leest asynchroon een regel tekens en retourneert de gegevens als een tekenreeks. |
ReadLineAsync()
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
Leest asynchroon een regel tekens en retourneert de gegevens als een tekenreeks.
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)Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van de TResult parameter bevat de volgende regel van de tekstlezer of is null als alle tekens zijn gelezen.
- Kenmerken
Uitzonderingen
Het aantal tekens in de volgende regel is groter dan Int32.MaxValue.
De tekstlezer is verwijderd.
De lezer wordt momenteel gebruikt door een eerdere leesbewerking.
Opmerkingen
De TextReader klasse is een abstracte klasse. Daarom maakt u deze niet instantiëren in uw code. Zie de methode voor een voorbeeld van het gebruik van de ReadLineAsyncStreamReader.ReadLineAsync methode.
Als de huidige TextReader de standaardinvoerstroom vertegenwoordigt die door de Console.In eigenschap wordt geretourneerd, wordt de ReadLineAsync methode synchroon uitgevoerd in plaats van asynchroon.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ReadLine()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
- ReadLineAsync()
- ReadLineAsync()
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
ReadLineAsync(CancellationToken)
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
- Bron:
- TextReader.cs
Leest asynchroon een regel tekens en retourneert de gegevens als een tekenreeks.
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)Parameters
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Een waardetaak die de asynchrone leesbewerking vertegenwoordigt. De waarde van de TResult parameter bevat de volgende regel van de tekstlezer of is null als alle tekens zijn gelezen.
Uitzonderingen
Het aantal tekens in de volgende regel is groter dan Int32.MaxValue.
De tekstlezer is verwijderd.
De lezer wordt momenteel gebruikt door een eerdere leesbewerking.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
De TextReader klasse is een abstracte klasse. Daarom maakt u deze niet instantiëren in uw code. Zie de methode voor een voorbeeld van het gebruik van de ReadLineAsync(CancellationToken)ReadLineAsync(CancellationToken) methode.
Als de huidige TextReader de standaardinvoerstroom vertegenwoordigt die door de Console.In eigenschap wordt geretourneerd, wordt de ReadLineAsync(CancellationToken) methode synchroon uitgevoerd in plaats van asynchroon.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ReadLine()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
