StreamReader.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 az aktuális adatfolyamból, és sztringként adja vissza az adatokat.
ReadLineAsync(CancellationToken)	Egy karaktersort aszinkron módon olvas be az aktuális adatfolyamból, és sztringként adja vissza az adatokat.

ReadLineAsync()

Forrás:

StreamReader.cs

Egy karaktersort aszinkron módon olvas be az aktuális adatfolyamból, és sztringként adja vissza az adatokat.

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)

Válaszok

Task<String>

Az aszinkron olvasási műveletet képviselő feladat. A paraméter értéke a TResult stream 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 stream el lett dobva.

InvalidOperationException

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

Példák

Az alábbi példa bemutatja, hogyan olvasható be a fájl első sora a ReadLineAsync() metódus használatával.

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

Megjegyzések

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: .

ReadLineAsync(CancellationToken)

Forrás:

StreamReader.cs

Egy karaktersort aszinkron módon olvas be az aktuális adatfolyamból, és sztringként adja vissza az adatokat.

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)

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 következő sort tartalmazza a streamből, 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 streamolvasó 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

Ha ezt a metódust megszakítják cancellationToken, előfordulhat, hogy egyes, az aktuálisból Stream beolvasott, de nem tárolt adatok (a StreamReader) vagy visszaadott adatok (a hívónak) elvesznek.

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: .