StringReader Classe

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Implémente TextReader qui lit une chaîne.

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

public class StringReader : System.IO.TextReader

[System.Serializable]
public class StringReader : System.IO.TextReader

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

type StringReader = class
    inherit TextReader

[<System.Serializable>]
type StringReader = class
    inherit TextReader

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

Public Class StringReader
Inherits TextReader

Héritage: Object

TextReader
StringReader

Héritage: Object

MarshalByRefObject

TextReader
StringReader

Attributs: SerializableAttribute ComVisibleAttribute

Exemples

L’exemple suivant montre comment lire une chaîne entière de manière 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 méthode ou la Read ReadAsync méthode, une ligne à la fois à l’aide de la méthode ou de la ReadLineAsync ReadLine méthode et une chaîne entière à l’aide de la ReadToEnd méthode ou de la ReadToEndAsync méthode.

Notes

Ce type implémente l’interface IDisposable, mais il n’a en fait aucune ressource à supprimer. Cela signifie que sa suppression en appelant directement Dispose() ou en utilisant une construction de langage telle que using (en C#) ou Using (en Visual Basic) n’est pas nécessaire.

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

Action à réaliser...	Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte.	Procédure : écrire du texte dans un fichier
Écrivez dans un fichier texte.	Procédure : écrire du texte dans un fichier
Lire à partir d’un fichier texte.	Procédure : lire le texte d’un fichier
Ajoutez du texte à un fichier.	Procédure : ouvrir un fichier journal et y ajouter des éléments File.AppendText FileInfo.AppendText
Obtenez la taille d’un fichier.	FileInfo.Length
Obtient les attributs d’un fichier.	File.GetAttributes
Définissez les attributs d’un fichier.	File.SetAttributes
Déterminez si un fichier existe.	File.Exists
Lit à partir d’un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment
Écrire dans un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment

Constructeurs

StringReader(String)

Initialise une nouvelle instance de la classe StringReader qui lit la chaîne spécifiée.

Méthodes

Close()	Ferme le StringReader.
Close()	Ferme le TextReader et libère toutes les ressources système associées au `TextReader`. (Hérité de TextReader)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de 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 StringReader 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()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. 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 Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
Peek()	Retourne le caractère disponible suivant, mais ne le consomme pas.
Read()	Lit le caractère suivant dans la chaîne d’entrée et avance sa position d’un caractère.
Read(Char[], Int32, Int32)	Lit un bloc de caractères dans la chaîne d’entrée et avance la position du caractère de `count`.
Read(Span<Char>)	Lit tous les caractères de la chaîne d’entrée en commençant à la position actuelle, et avance la position actuelle à la fin de la chaîne d’entrée.
Read(Span<Char>)	Lit les caractères à partir du lecteur actuel et écrit les données dans la mémoire tampon spécifiée. (Hérité de TextReader)
ReadAsync(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères à partir 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é.
ReadAsync(Char[], Int32, Int32)	Lit de façon asynchrone un nombre maximal de caractères spécifié dans le 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)
ReadAsync(Memory<Char>, CancellationToken)	Lit de façon asynchrone tous les caractères de la chaîne d’entrée en commençant à la position actuelle, et avance la position actuelle à la fin de la chaîne d’entrée.
ReadAsync(Memory<Char>, CancellationToken)	Lit de façon asynchrone les caractères du flux actuel dans un bloc de mémoire. (Hérité de TextReader)
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)
ReadBlock(Span<Char>)	Lit tous les caractères de la chaîne d’entrée en commençant à la position actuelle, et avance la position actuelle à la fin de la chaîne d’entrée.
ReadBlock(Span<Char>)	Lit les caractères à partir du flux actuel et écrit les données dans une mémoire tampon. (Hérité de TextReader)
ReadBlockAsync(Char[], Int32, Int32)	Lit un nombre maximal spécifié de caractères à partir 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é.
ReadBlockAsync(Char[], Int32, Int32)	Lit de façon asynchrone un nombre maximal de caractères spécifié dans le 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(Memory<Char>, CancellationToken)	Lit de façon asynchrone tous les caractères de la chaîne d’entrée en commençant à la position actuelle, et avance la position actuelle à la fin de la chaîne d’entrée.
ReadBlockAsync(Memory<Char>, CancellationToken)	Lit de façon asynchrone les caractères à partir du flux actuel et écrit les données dans une mémoire tampon. (Hérité de TextReader)
ReadLine()	Lit une ligne de caractères à partir de la chaîne en cours 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 en cours et retourne les données sous forme de chaîne.
ReadLineAsync()	Lit une ligne de caractères de manière asynchrone et retourne les données sous forme de chaîne. (Hérité de TextReader)
ReadLineAsync(CancellationToken)	Lit une ligne de caractères de manière asynchrone à partir de la chaîne en cours et retourne les données sous forme de chaîne.
ReadLineAsync(CancellationToken)	Lit une ligne de caractères de manière asynchrone et retourne les données sous forme de chaîne. (Hérité de TextReader)
ReadToEnd()	Lit tous les caractères entre la position actuelle et la fin de la chaîne, puis les retourne sous la forme d’une chaîne unique.
ReadToEndAsync()	Lit tous les caractères entre la position actuelle et la fin de la chaîne de manière asynchrone, puis les retourne sous la forme d’une chaîne unique.
ReadToEndAsync()	Lit tous les caractères entre la position actuelle et la fin du lecteur de texte de manière asynchrone, puis les retourne sous la forme d'une chaîne. (Hérité de TextReader)
ReadToEndAsync(CancellationToken)	Lit tous les caractères entre la position actuelle et la fin de la chaîne de manière asynchrone, puis les retourne sous la forme d’une chaîne unique.
ReadToEndAsync(CancellationToken)	Lit tous les caractères entre la position actuelle et la fin du lecteur de texte de manière asynchrone, puis les retourne sous la forme d'une chaîne. (Hérité de TextReader)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Pour obtenir une description de ce membre, consultez Dispose().

(Hérité de TextReader)

S’applique à