StreamReader.ReadToEndAsync 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 |
|---|---|
| ReadToEndAsync() |
Liest alle Zeichen von der aktuellen Position bis zum Ende des Datenstroms asynchron und gibt sie als eine Zeichenfolge zurück. |
| ReadToEndAsync(CancellationToken) |
Liest alle Zeichen von der aktuellen Position bis zum Ende des Datenstroms asynchron und gibt sie als eine Zeichenfolge zurück. |
ReadToEndAsync()
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
Liest alle Zeichen von der aktuellen Position bis zum Ende des Datenstroms asynchron und gibt sie als eine Zeichenfolge zurück.
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)Gibt zurück
Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult Parameters enthält eine Zeichenfolge mit den Zeichen von der aktuellen Position bis zum Ende des Datenstroms.
- Attribute
Ausnahmen
Die Anzahl der Zeichen ist größer als Int32.MaxValue.
Der Datenstrom wurde gelöscht.
Der Leser wird derzeit von einem vorherigen Lesevorgang verwendet.
Beispiele
Das folgende Beispiel zeigt, wie der Inhalt einer Datei mithilfe der ReadToEndAsync() Methode gelesen wird.
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
Hinweise
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 ReadToEnd().
Gilt für:
ReadToEndAsync(CancellationToken)
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
- Quelle:
- StreamReader.cs
Liest alle Zeichen von der aktuellen Position bis zum Ende des Datenstroms asynchron und gibt sie als eine Zeichenfolge zurück.
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)Parameter
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult Parameters enthält eine Zeichenfolge mit den Zeichen von der aktuellen Position bis zum Ende des Datenstroms.
Ausnahmen
Die Anzahl der Zeichen ist größer als Int32.MaxValue.
Der Streamleser wurde verworfen.
Der Leser wird derzeit von einem vorherigen Lesevorgang verwendet.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Wenn diese Methode über cancellationTokenabgebrochen wird, gehen möglicherweise einige Daten verloren, die aus dem aktuellen Stream , aber nicht gespeicherten (vom StreamReader) oder an den Aufrufer zurückgegeben wurden.
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 ReadToEnd().
