StringReader.ReadLineAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
ReadLineAsync()	Načte řádek znaků asynchronně z aktuálního řetězce a vrátí data jako řetězec.
ReadLineAsync(CancellationToken)	Načte řádek znaků asynchronně z aktuálního řetězce a vrátí data jako řetězec.

ReadLineAsync()

Zdroj:

StringReader.cs

Načte řádek znaků asynchronně z aktuálního řetězce a vrátí data jako řetězec.

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)

Návraty

Task<String>

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek od čtečky řetězců, nebo pokud null byly přečteny všechny znaky.

Výjimky

ArgumentOutOfRangeException

Počet znaků na dalším řádku je větší než Int32.MaxValue.

ObjectDisposedException

Čtečka řetězců byla uvolněna.

InvalidOperationException

Čtečka je aktuálně používána předchozí operací čtení.

Příklady

Následující příklad ukazuje, jak číst jeden řádek najednou z řetězce asynchronně.

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            string readText;

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                while ((readText = await reader.ReadLineAsync()) != null)
                {
                    Console.WriteLine(readText);
                }
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadLineAsync()
            While Not IsNothing(readText)
                Console.WriteLine(readText)
                readText = Await reader.ReadLineAsync()
            End While
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadLine().

ReadLineAsync(CancellationToken)

Zdroj:

StringReader.cs

Načte řádek znaků asynchronně z aktuálního řetězce a vrátí data jako řetězec.

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)

Parametry

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

ValueTask<String>

Hodnota úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje další řádek od čtečky řetězců, nebo pokud null byly načteny všechny znaky.

Výjimky

ArgumentOutOfRangeException

Počet znaků na dalším řádku je větší než Int32.MaxValue.

ObjectDisposedException

Čtečka řetězců byla uvolněna.

InvalidOperationException

Čtečka je aktuálně používána předchozí operací čtení.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadLine().