StringReader.ReadLineAsync Méthode

Définition

Espace de noms:

System.IO

Assembly:

mscorlib.dll

Lit une ligne de caractères de manière asynchrone à partir de la chaîne actuelle et retourne les données sous forme de chaîne.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadLineAsync();

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>

Public Overrides Function ReadLineAsync () As Task(Of String)

Retours

Task<String>

Tâche qui représente l’opération de lecture asynchrone. La valeur du TResult paramètre contient la ligne suivante à partir du lecteur de chaîne ou si null tous les caractères ont été lus.

Attributs

ComVisibleAttribute

Exceptions

ArgumentOutOfRangeException

Le nombre de caractères dans la ligne suivante est supérieur à Int32.MaxValue.

ObjectDisposedException

Le lecteur de chaîne a été supprimé.

InvalidOperationException

Le lecteur est actuellement utilisé par une opération de lecture précédente.

Exemples

L’exemple suivant montre comment lire une ligne à la fois à partir d’une chaîne de façon asynchrone.

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
'

Remarques

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par ReadLine().