TextReader.ReadLineAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
ReadLineAsync()	Bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.
ReadLineAsync(CancellationToken)	Bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.

ReadLineAsync()

Kaynak:

TextReader.cs

Bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.

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

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

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

Public Overridable 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, metin okuyucudan 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

Metin okuyucu atıldı.

InvalidOperationException

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

Açıklamalar

TextReader sınıfı soyut bir sınıftır. Bu nedenle, kodunuzda örneği oluşturmazsınız. ReadLineAsync yöntemini kullanma örneği için StreamReader.ReadLineAsync yöntemine bakın.

current TextReader özelliği tarafından Console.In döndürülen standart giriş akışını temsil ederse, ReadLineAsync yöntemi zaman uyumsuz olarak değil zaman uyumlu olarak yürütülür.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ReadLine()oluşan özel durumlara bakın.

Ayrıca bkz.

• ReadLineAsync()
• ReadLineAsync()
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma

ReadLineAsync(CancellationToken)

Kaynak:

TextReader.cs

Bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.

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

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

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

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

Parametreler

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

ValueTask<String>

Zaman uyumsuz okuma işlemini temsil eden bir değer görevi. parametresinin TResult değeri, metin okuyucudan 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

Metin okuyucu 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

TextReader sınıfı soyut bir sınıftır. Bu nedenle, kodunuzda örneği oluşturmazsınız. ReadLineAsync(CancellationToken) yöntemini kullanma örneği için ReadLineAsync(CancellationToken) yöntemine bakın.

current TextReader özelliği tarafından Console.In döndürülen standart giriş akışını temsil ederse, ReadLineAsync(CancellationToken) yöntemi zaman uyumsuz olarak değil zaman uyumlu olarak yürütülür.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ReadLine()oluşan özel durumlara bakın.