StreamReader.ReadToEndAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

ReadToEndAsync()	Geçerli konumdan akışın sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları bir dize olarak döndürür.
ReadToEndAsync(CancellationToken)	Geçerli konumdan akışın sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları bir dize olarak döndürür.

ReadToEndAsync()

Kaynak:

StreamReader.cs

Geçerli konumdan akışın sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları bir dize olarak döndürür.

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)

Döndürülenler

Task<String>

Zaman uyumsuz okuma işlemini temsil eden görev. parametresinin TResult değeri, geçerli konumdan akışın sonuna kadar olan karakterleri içeren bir dize içerir.

Özel durumlar

ArgumentOutOfRangeException

Karakter sayısı Int32.MaxValue değerinden büyük.

ObjectDisposedException

Akış atıldı.

InvalidOperationException

Okuyucu şu anda önceki bir okuma işlemi tarafından kullanılıyor.

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak dosyanın içeriğinin nasıl okunduğu gösterilmektedir ReadToEndAsync() .

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

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ReadToEnd()özel durumlara bakın.

ReadToEndAsync(CancellationToken)

Kaynak:

StreamReader.cs

Geçerli konumdan akışın sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları bir dize olarak döndürür.

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)

Parametreler

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç.

Döndürülenler

Task<String>

Zaman uyumsuz okuma işlemini temsil eden görev. parametresinin TResult değeri, geçerli konumdan akışın sonuna kadar olan karakterleri içeren bir dize içerir.

Özel durumlar

ArgumentOutOfRangeException

Karakter sayısı Int32.MaxValue değerinden büyük.

ObjectDisposedException

Akış okuyucusu atıldı.

InvalidOperationException

Okuyucu şu anda önceki bir okuma işlemi tarafından kullanılıyor.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem aracılığıyla cancellationTokeniptal edilirse, geçerli Stream olandan okunan ancak depolanmayan ( StreamReadertarafından ) veya döndürülen (çağırana) bazı veriler kaybolabilir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ReadToEnd()özel durumlara bakın.