StreamReader.ReadLineAsync Metod

Definition

Namnområde:
System.IO
Sammansättningar:
mscorlib.dll, System.IO.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.IO.dll
Sammansättning:
System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Överlagringar

Name Description
ReadLineAsync()

Läser en rad tecken asynkront från den aktuella strömmen och returnerar data som en sträng.
ReadLineAsync(CancellationToken)

Läser en rad tecken asynkront från den aktuella strömmen och returnerar data som en sträng.

ReadLineAsync()

Källa:
StreamReader.cs
Källa:
StreamReader.cs
Källa:
StreamReader.cs
Källa:
StreamReader.cs
Källa:
StreamReader.cs

Läser en rad tecken asynkront från den aktuella strömmen och returnerar data som en sträng.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();
public override System.Threading.Tasks.Task<string> ReadLineAsync();
public override System.Threading.Tasks.Task<string?> ReadLineAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadLineAsync();
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
Public Overrides Function ReadLineAsync () As Task(Of String)

Returer

Task<String>

En uppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller nästa rad från strömmen, eller null om alla tecken har lästs.

Attribut
ComVisibleAttribute

Undantag

ArgumentOutOfRangeException

Antalet tecken på nästa rad är större än Int32.MaxValue.

ObjectDisposedException

Strömmen har tagits bort.

InvalidOperationException

Läsaren används för närvarande av en tidigare läsåtgärd.

Exempel

I följande exempel visas hur du läser den första raden i en fil med hjälp ReadLineAsync() av metoden .

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

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ReadLine().

Gäller för

ReadLineAsync(CancellationToken)

Källa:
StreamReader.cs
Källa:
StreamReader.cs
Källa:
StreamReader.cs
Källa:
StreamReader.cs
Källa:
StreamReader.cs

Läser en rad tecken asynkront från den aktuella strömmen och returnerar data som en sträng.

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)

Parametrar

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden.

Returer

ValueTask<String>

En värdeuppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller nästa rad från strömmen, eller null om alla tecken har lästs.

Undantag

ArgumentOutOfRangeException

Antalet tecken på nästa rad är större än Int32.MaxValue.

ObjectDisposedException

Strömläsaren har tagits bort.

InvalidOperationException

Läsaren används för närvarande av en tidigare läsåtgärd.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Om den här metoden avbryts via cancellationTokenkan vissa data som har lästs från den aktuella Stream men inte lagrats (av StreamReader) eller returnerats (till anroparen) gå förlorade.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ReadLine().

Gäller för