TextReader.ReadLineAsync Metódus

Definíció

Névtér:

System.IO

Szerelvények:

netstandard.dll, System.Runtime.dll

Túlterhelések

Name	Description
ReadLineAsync()	Egy karaktersort aszinkron módon olvas be, és sztringként adja vissza az adatokat.
ReadLineAsync(CancellationToken)	Egy karaktersort aszinkron módon olvas be, és sztringként adja vissza az adatokat.

ReadLineAsync()

Forrás:

TextReader.cs

Egy karaktersort aszinkron módon olvas be, és sztringként adja vissza az adatokat.

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)

Válaszok

Task<String>

Az aszinkron olvasási műveletet képviselő feladat. A paraméter értéke TResult a szövegolvasó következő sorát tartalmazza, vagy ha null az összes karakter be van olvasva.

Kivételek

ArgumentOutOfRangeException

A következő sorban szereplő karakterek száma nagyobb, mint az Int32.MaxValue.

ObjectDisposedException

A szövegolvasó el lett adva.

InvalidOperationException

Az olvasót jelenleg egy korábbi olvasási művelet használja.

Megjegyzések

Az TextReader osztály egy absztrakt osztály. Ezért nem példányosíthatja azt a kódban. A metódus használatára ReadLineAsync példaként tekintse meg a metódust StreamReader.ReadLineAsync .

Ha az áram TextReader a tulajdonság által Console.In visszaadott standard bemeneti adatfolyamot jelöli, a ReadLineAsync metódus szinkron módon hajtja végre, nem pedig aszinkron módon.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ReadLine()kiadott kivételeket: .

Lásd még

• System.IO.StreamReader.ReadLineAsync
• System.IO.StringReader.ReadLineAsync
• Fájl és folyam I/O
• Útmutató: Szöveg beolvasása fájlból
• Útmutató: Szöveg írása fájlba

ReadLineAsync(CancellationToken)

Forrás:

TextReader.cs

Egy karaktersort aszinkron módon olvas be, és sztringként adja vissza az adatokat.

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)

Paraméterek

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat.

Válaszok

ValueTask<String>

Az aszinkron olvasási műveletet képviselő értékfeladat. A paraméter értéke TResult a szövegolvasó következő sorát tartalmazza, vagy ha null az összes karakter be van olvasva.

Kivételek

ArgumentOutOfRangeException

A következő sorban szereplő karakterek száma nagyobb, mint az Int32.MaxValue.

ObjectDisposedException

A szövegolvasó el lett adva.

InvalidOperationException

Az olvasót jelenleg egy korábbi olvasási művelet használja.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Az TextReader osztály egy absztrakt osztály. Ezért nem példányosíthatja azt a kódban. A metódus használatára ReadLineAsync(CancellationToken) példaként tekintse meg a metódust ReadLineAsync(CancellationToken) .

Ha az áram TextReader a tulajdonság által Console.In visszaadott standard bemeneti adatfolyamot jelöli, a ReadLineAsync(CancellationToken) metódus szinkron módon hajtja végre, nem pedig aszinkron módon.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ReadLine()kiadott kivételeket: .