StringReader.ReadToEndAsync 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
ReadToEndAsync()

Läser alla tecken från den aktuella positionen till slutet av strängen asynkront och returnerar dem som en enda sträng.
ReadToEndAsync(CancellationToken)

Läser alla tecken från den aktuella positionen till slutet av strängen asynkront och returnerar dem som en enda sträng.

ReadToEndAsync()

Källa:
StringReader.cs
Källa:
StringReader.cs
Källa:
StringReader.cs
Källa:
StringReader.cs
Källa:
StringReader.cs

Läser alla tecken från den aktuella positionen till slutet av strängen asynkront och returnerar dem som en enda sträng.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync();
public override System.Threading.Tasks.Task<string> ReadToEndAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadToEndAsync();
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
Public Overrides Function ReadToEndAsync () 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 en sträng med tecknen från den aktuella positionen till slutet av strängen.

Attribut
ComVisibleAttribute

Undantag

ArgumentOutOfRangeException

Antalet tecken är större än Int32.MaxValue.

ObjectDisposedException

Strängläsaren 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 en hel sträng asynkront.

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");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                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.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

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 ReadToEnd().

Gäller för

ReadToEndAsync(CancellationToken)

Källa:
StringReader.cs
Källa:
StringReader.cs
Källa:
StringReader.cs
Källa:
StringReader.cs
Källa:
StringReader.cs

Läser alla tecken från den aktuella positionen till slutet av strängen asynkront och returnerar dem som en enda sträng.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<string> ReadToEndAsync(System.Threading.CancellationToken cancellationToken);
override this.ReadToEndAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Overrides Function ReadToEndAsync (cancellationToken As CancellationToken) As Task(Of String)

Parametrar

cancellationToken
CancellationToken

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

Returer

Task<String>

En uppgift som representerar den asynkrona läsåtgärden. Värdet för parametern TResult innehåller en sträng med tecknen från den aktuella positionen till slutet av strängen.

Undantag

ArgumentOutOfRangeException

Antalet tecken är större än Int32.MaxValue.

ObjectDisposedException

Stränglä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

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 ReadToEnd().

Gäller för