StreamReader.ReadToEndAsync 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 |
|---|---|
| ReadToEndAsync() |
Leest alle tekens van de huidige positie naar het einde van de stroom asynchroon en retourneert ze als één tekenreeks. |
| ReadToEndAsync(CancellationToken) |
Leest alle tekens van de huidige positie naar het einde van de stroom asynchroon en retourneert ze als één tekenreeks. |
ReadToEndAsync()
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
Leest alle tekens van de huidige positie naar het einde van de stroom asynchroon en retourneert ze als één tekenreeks.
public:
override System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync();public override System.Threading.Tasks.Task<string> ReadToEndAsync();[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadToEndAsync();override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>Public Overrides Function ReadToEndAsync () As Task(Of String)Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van de TResult parameter bevat een tekenreeks met de tekens van de huidige positie tot het einde van de stroom.
- Kenmerken
Uitzonderingen
Het aantal tekens is groter dan Int32.MaxValue.
De stroom is verwijderd.
De lezer wordt momenteel gebruikt door een eerdere leesbewerking.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de inhoud van een bestand kunt lezen met behulp van de ReadToEndAsync() methode.
using System;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static async Task Main()
{
await ReadCharacters();
}
static async Task ReadCharacters()
{
String result;
using (StreamReader reader = File.OpenText("existingfile.txt"))
{
Console.WriteLine("Opened file.");
result = await reader.ReadToEndAsync();
Console.WriteLine("Contains: " + result);
}
}
}
}
Imports System.IO
Module Module1
Sub Main()
ReadCharacters()
End Sub
Async Sub ReadCharacters()
Dim result As String
Using reader As StreamReader = File.OpenText("existingfile.txt")
Console.WriteLine("Opened file.")
result = Await reader.ReadToEndAsync()
Console.WriteLine("Contains: " + result)
End Using
End Sub
End Module
Opmerkingen
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 ReadToEnd()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
ReadToEndAsync(CancellationToken)
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
- Bron:
- StreamReader.cs
Leest alle tekens van de huidige positie naar het einde van de stroom asynchroon en retourneert ze als één tekenreeks.
public:
override System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<string> ReadToEndAsync(System.Threading.CancellationToken cancellationToken);override this.ReadToEndAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Overrides Function ReadToEndAsync (cancellationToken As CancellationToken) As Task(Of String)Parameters
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Een taak die de asynchrone leesbewerking vertegenwoordigt. De waarde van de TResult parameter bevat een tekenreeks met de tekens van de huidige positie tot het einde van de stroom.
Uitzonderingen
Het aantal tekens is groter dan Int32.MaxValue.
De streamlezer is verwijderd.
De lezer wordt momenteel gebruikt door een eerdere leesbewerking.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Als deze methode wordt geannuleerd via cancellationToken, gaan sommige gegevens die zijn gelezen uit de huidige Stream , maar niet zijn opgeslagen (door de StreamReader) of geretourneerde gegevens (naar de aanroeper) mogelijk verloren.
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 ReadToEnd()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
