Sdílet prostřednictvím


StringReader.ReadToEndAsync Metoda

Definice

Přetížení

ReadToEndAsync()

Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.

ReadToEndAsync(CancellationToken)

Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.

ReadToEndAsync()

Zdroj:
StringReader.cs
Zdroj:
StringReader.cs
Zdroj:
StringReader.cs

Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.

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)

Návraty

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje řetězec se znaky od aktuální pozice do konce řetězce.

Atributy

Výjimky

Počet znaků je větší než Int32.MaxValue.

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

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

Příklady

Následující příklad ukazuje, jak číst celý řetězec 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");

            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
'

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadToEnd().

Platí pro

ReadToEndAsync(CancellationToken)

Zdroj:
StringReader.cs
Zdroj:
StringReader.cs
Zdroj:
StringReader.cs

Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.

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)

Parametry

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Úloha, která představuje asynchronní operaci čtení. Hodnota parametru TResult obsahuje řetězec se znaky od aktuální pozice do konce řetězce.

Výjimky

Počet znaků je větší než Int32.MaxValue.

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

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

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ReadToEnd().

Platí pro