StreamReader.ReadLineAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

ReadLineAsync()	Geçerli akıştan zaman uyumsuz olarak bir karakter satırı okur ve verileri dize olarak döndürür.
ReadLineAsync(CancellationToken)	Geçerli akıştan zaman uyumsuz olarak bir karakter satırı okur ve verileri dize olarak döndürür.

ReadLineAsync()

Kaynak:

StreamReader.cs

Geçerli akıştan zaman uyumsuz olarak bir karakter satırı okur ve verileri dize olarak döndürür.

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

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

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

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

Döndürülenler

Task<String>

Zaman uyumsuz okuma işlemini temsil eden görev. parametresinin TResult değeri akıştan sonraki satırı içerir veya null tüm karakterlerin okunup okunmadığını gösterir.

Özel durumlar

ArgumentOutOfRangeException

Sonraki satırdaki 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 ilk satırının nasıl okunduğu gösterilmektedir ReadLineAsync() .

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.ReadLineAsync();
                Console.WriteLine("First line 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.ReadLineAsync()
            Console.WriteLine("First line 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 ReadLine()özel durumlara bakın.

ReadLineAsync(CancellationToken)

Kaynak:

StreamReader.cs

Geçerli akıştan zaman uyumsuz olarak bir karakter satırı okur ve verileri dize olarak döndürür.

public:
 override System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>

Public Overrides Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)

Parametreler

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç.

Döndürülenler

ValueTask<String>

Zaman uyumsuz okuma işlemini temsil eden bir değer görevi. parametresinin TResult değeri akıştan sonraki satırı içerir veya null tüm karakterlerin okunup okunmadığını gösterir.

Özel durumlar

ArgumentOutOfRangeException

Sonraki satırdaki 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 ReadLine()özel durumlara bakın.