StringReader Class

Definition

Implémente TextReader qui lit une chaîne.Implements a TextReader that reads from a string.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Inheritance
StringReader
Inheritance
Attributes

Examples

L’exemple suivant montre comment lire une chaîne entière de manière asynchrone.The following example shows how to read an entire string asynchronously.

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
'

Remarks

StringReader vous permet de lire une chaîne de façon synchrone ou asynchrone.StringReader enables you to read a string synchronously or asynchronously. Vous pouvez lire un caractère à la fois avec la Read ou la méthode ReadAsync, une ligne à la fois à l’aide de la ReadLine ou de la méthode ReadLineAsync et une chaîne entière à l’aide de la ReadToEnd ou de la méthode ReadToEndAsync.You can read a character at a time with the Read or the ReadAsync method, a line at a time using the ReadLine or the ReadLineAsync method and an entire string using the ReadToEnd or the ReadToEndAsync method.

Note

Ce type implémente l’interface IDisposable, mais il n’a en fait aucune ressource à supprimer.This type implements the IDisposable interface, but does not actually have any resources to dispose. 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.This means that disposing it by directly calling Dispose() or by using a language construct such as using (in C#) or Using (in Visual Basic) is not necessary.

Le tableau suivant répertorie des exemples d’autres tâches d’e/s typiques ou associées.The following table lists examples of other typical or related I/O tasks.

Action à réaliser...To do this... Consultez l'exemple décrit dans cette rubrique...See the example in this topic...
Créer un fichier texte.Create a text file. Comment : écrire du texte dans un fichierHow to: Write Text to a File
Écrire dans un fichier texte.Write to a text file. Comment : écrire du texte dans un fichierHow to: Write Text to a File
Lire à partir d’un fichier texte.Read from a text file. Comment : lire du texte dans un fichierHow to: Read Text from a File
Ajoutez du texte à un fichier.Append text to a file. Comment : ouvrir un fichier journal et y ajouter des élémentsHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Obtenir la taille d’un fichier.Get the size of a file. FileInfo.Length
Obtient les attributs d’un fichier.Get the attributes of a file. File.GetAttributes
Définir les attributs d’un fichier.Set the attributes of a file. File.SetAttributes
Déterminez si un fichier existe.Determine if a file exists. File.Exists
Lire à partir d’un fichier binaire.Read from a binary file. Comment : lire et écrire dans un fichier de données créé récemmentHow to: Read and Write to a Newly Created Data File
Écrire dans un fichier binaire.Write to a binary file. Comment : lire et écrire dans un fichier de données créé récemmentHow to: Read and Write to a Newly Created Data File

Constructors

StringReader(String)

Initialise une nouvelle instance de la classe StringReader qui lit la chaîne spécifiée.Initializes a new instance of the StringReader class that reads from the specified string.

Methods

Close()

Ferme le StringReader.Closes the StringReader.

Close()

Ferme le TextReader et libère toutes les ressources système associées au TextReader.Closes the TextReader and releases any system resources associated with the TextReader.

(Inherited from 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par l’objet TextReader.Releases all resources used by the TextReader object.

(Inherited from TextReader)
Dispose(Boolean)

Libère les ressources non managées utilisées par StringReader et libère éventuellement les ressources managées.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from 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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Peek()

Retourne le caractère disponible suivant, mais ne le consomme pas.Returns the next available character but does not consume it.

Read()

Lit le caractère suivant dans la chaîne d’entrée et avance sa position d’un caractère.Reads the next character from the input string and advances the character position by one character.

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.Reads a block of characters from the input string and advances the character position by 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.Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

Read(Span<Char>)

Lit les caractères à partir du lecteur actuel et écrit les données dans la mémoire tampon spécifiée.Reads the characters from the current reader and writes the data to the specified buffer.

(Inherited from 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é.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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é.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(Inherited from 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.Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

ReadAsync(Memory<Char>, CancellationToken)

Lit de façon asynchrone les caractères du flux actuel dans un bloc de mémoire.Asynchronously reads the characters from the current stream into a memory block.

(Inherited from 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é.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

(Inherited from 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.Reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlock(Span<Char>)

Lit les caractères à partir du flux actuel et écrit les données dans une mémoire tampon.Reads the characters from the current stream and writes the data to a buffer.

(Inherited from 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é.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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é.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(Inherited from 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.Asynchronously reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

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.Asynchronously reads the characters from the current stream and writes the data to a buffer.

(Inherited from 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.Reads a line of characters from the current string and returns the data as a string.

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.Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadLineAsync()

Lit une ligne de caractères de manière asynchrone et retourne les données sous forme de chaîne.Reads a line of characters asynchronously and returns the data as a string.

(Inherited from 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.Reads all characters from the current position to the end of the string and returns them as a single string.

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.Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

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.Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.

(Inherited from TextReader)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

IDisposable.Dispose()

Pour obtenir une description de ce membre, consultez Dispose().For a description of this member, see Dispose().

(Inherited from TextReader)

Applies to

See also