TextReader.ReadLineAsync Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Aşırı Yüklemeler

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
Kaynak:
TextReader.cs
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 ();
public virtual System.Threading.Tasks.Task<string?> ReadLineAsync ();
[System.Runtime.InteropServices.ComVisible(false)]
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>
[<System.Runtime.InteropServices.ComVisible(false)>]
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.

Öznitelikler
ComVisibleAttribute

Ö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. yöntemini kullanma ReadLineAsync örneği için yöntemine StreamReader.ReadLineAsync 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 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.

Ayrıca bkz.

Şunlara uygulanır

ReadLineAsync(CancellationToken)

Kaynak:
TextReader.cs
Kaynak:
TextReader.cs
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 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, 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. yöntemini kullanma ReadLineAsync(CancellationToken) örneği için yöntemine ReadLineAsync(CancellationToken) 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 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.

Şunlara uygulanır