StreamReader.ReadToEndAsync Método

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.IO.dll

Ensamblado:: System.Runtime.dll

Ensamblados:: mscorlib.dll, netstandard.dll

Ensamblado:: System.Runtime.Extensions.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Lee de forma asincrónica todos los caracteres desde la posición actual hasta el final de la secuencia y los devuelve como una cadena.Reads all characters from the current position to the end of the stream asynchronously and returns them as one string.

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)

Devoluciones

Task<String>

Tarea que representa la operación de lectura asincrónica.A task that represents the asynchronous read operation. El valor del parámetro TResult contiene una cadena con los caracteres desde la posición actual hasta el final de la secuencia.The value of the TResult parameter contains a string with the characters from the current position to the end of the stream.

Atributos: ComVisibleAttribute

Excepciones

ArgumentOutOfRangeException

El número de caracteres es mayor que MaxValue.The number of characters is larger than MaxValue.

ObjectDisposedException

Se ha eliminado la secuencia.The stream has been disposed.

InvalidOperationException

Una operación de lectura anterior está usando actualmente el lector.The reader is currently in use by a previous read operation.

Ejemplos

En el ejemplo siguiente se muestra cómo leer el contenido de un archivo mediante el ReadToEndAsync() método.The following example shows how to read the contents of a file by using the ReadToEndAsync() method.

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

Se aplica a