StringReader Classe

Définition

Espace de noms:

System.IO

Assembly:

mscorlib.dll

Implémente une TextReader lecture à partir d’une chaîne.

public ref class StringReader : System::IO::TextReader

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Héritage

Object

MarshalByRefObject

TextReader

StringReader

Attributs

SerializableAttribute ComVisibleAttribute

Exemples

L’exemple suivant montre comment lire une chaîne entière 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");

            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
'

Remarques

StringReader vous permet de lire une chaîne de manière synchrone ou asynchrone. Vous pouvez lire un caractère à la fois avec la ou la ReadAsyncRead méthode, une ligne à la fois à l’aide de la ou de la ReadLineReadLineAsync méthode et une chaîne entière à l’aide de la ReadToEnd ou de la ReadToEndAsync méthode.

Note

Ce type implémente l’interface IDisposable , mais n’a pas réellement de ressources à supprimer. Cela signifie que la suppression directe en appelant directement Dispose() ou en utilisant une construction de langage telle que using (en C#) ou Using (dans Visual Basic) n’est pas nécessaire.

Le tableau suivant répertorie des exemples d’autres tâches d’E/S classiques ou connexes.

Pour ce faire...	Consultez l’exemple de cette rubrique...
Créez un fichier texte.	Guide pratique pour écrire du texte dans un fichier
Écrire dans un fichier texte.	Guide pratique pour écrire du texte dans un fichier
Lire à partir d’un fichier texte.	Guide pratique pour lire du texte à partir d’un fichier
Ajoutez du texte à un fichier.	Guide pratique pour ouvrir et ajouter à un fichier journal File.AppendText FileInfo.AppendText
Obtenez la taille d’un fichier.	FileInfo.Length
Obtenir les attributs d’un fichier.	File.GetAttributes
Définissez les attributs d’un fichier.	File.SetAttributes
Déterminez si un fichier existe.	File.Exists
Lire à partir d’un fichier binaire.	Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
Écrivez dans un fichier binaire.	Guide pratique pour lire et écrire dans un fichier de données nouvellement créé

Constructeurs

Nom	Description
StringReader(String)	Initialise une nouvelle instance de la StringReader classe qui lit à partir de la chaîne spécifiée.

Méthodes

Nom	Description
Close()	Ferme le StringReader.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par l’objet TextReader . (Hérité de TextReader)
Dispose(Boolean)	Libère les ressources non managées utilisées par les StringReader ressources gérées et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
Peek()	Retourne le caractère disponible suivant, mais ne l’utilise pas.
Read()	Lit le caractère suivant de la chaîne d’entrée et avance la position du caractère d’un caractère.
Read(Char[], Int32, Int32)	Lit un bloc de caractères de la chaîne d’entrée et avance la position du caractère par count.
ReadAsync(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères de la chaîne actuelle de manière asynchrone et écrit les données dans une mémoire tampon, en commençant à l’index spécifié.
ReadBlock(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères à partir du lecteur de texte actuel et écrit les données dans une mémoire tampon, en commençant à l’index spécifié. (Hérité de TextReader)
ReadBlockAsync(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères de la chaîne actuelle de manière asynchrone et écrit les données dans une mémoire tampon, en commençant à l’index spécifié.
ReadLine()	Lit une ligne de caractères de la chaîne actuelle et retourne les données sous forme de chaîne.
ReadLineAsync()	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.
ReadToEnd()	Lit tous les caractères de la position actuelle à la fin de la chaîne et les retourne sous forme de chaîne unique.
ReadToEndAsync()	Lit tous les caractères de la position actuelle à la fin de la chaîne de façon asynchrone et les retourne sous forme de chaîne unique.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• TextReader
• StringWriter
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier