StreamReader.ReadToEndAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

ReadToEndAsync()	Přečte asynchronně všechny znaky od aktuální pozice do konce datového proudu a vrátí je jako jeden řetězec.
ReadToEndAsync(CancellationToken)	Přečte asynchronně všechny znaky od aktuální pozice do konce datového proudu a vrátí je jako jeden řetězec.

ReadToEndAsync()

Zdroj:

StreamReader.cs

Přečte asynchronně všechny znaky od aktuální pozice do konce datového proudu a vrátí je jako jeden řetězec.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync();

public override System.Threading.Tasks.Task<string> ReadToEndAsync ();

override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>

Public Overrides Function ReadToEndAsync () As Task(Of String)

Návraty

Task<String>

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje řetězec se znaky od aktuální pozice až po konec datového proudu.

Výjimky

ArgumentOutOfRangeException

Počet znaků je větší než Int32.MaxValue.

ObjectDisposedException

Datový proud byl odstraněn.

InvalidOperationException

Čtečka je aktuálně používána předchozí operací čtení.

Příklady

Následující příklad ukazuje, jak číst obsah souboru pomocí ReadToEndAsync() metody .

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadToEnd().

ReadToEndAsync(CancellationToken)

Zdroj:

StreamReader.cs

Přečte asynchronně všechny znaky od aktuální pozice do konce datového proudu a vrátí je jako jeden řetězec.

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)

Parametry

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Task<String>

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje řetězec se znaky od aktuální pozice až po konec datového proudu.

Výjimky

ArgumentOutOfRangeException

Počet znaků je větší než Int32.MaxValue.

ObjectDisposedException

Čtečka streamu byla odstraněna.

InvalidOperationException

Čtečka je aktuálně používána předchozí operací čtení.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Pokud je tato metoda zrušena prostřednictvím cancellationTokennástroje , mohou být ztracena některá data, která byla načtena z aktuálního Stream , ale nebyla uložena (uživatelem StreamReader) nebo vrácena (volajícímu).

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadToEnd().