StringReader StringReader StringReader StringReader Class

Définition

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

public ref 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
Héritage
Attributs

Exemples

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
'

Remarques

StringReadervous 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 ReadAsync méthode ou, une ligne à la ReadLineAsync fois à l’aide ReadLine de la méthode ou et une chaîne entière à ReadToEnd l’aide ReadToEndAsync de la méthode ou.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.

Notes

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.

Pour...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

Constructeurs

StringReader(String) StringReader(String) StringReader(String) 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.

Méthodes

Close() Close() Close() Close()

Ferme StringReader.Closes the StringReader.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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() Dispose() Dispose() 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) Dispose(Boolean) Dispose(Boolean) 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) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) 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() Peek() Peek() Peek()

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

Read() Read() Read() 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) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) 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>) Read(Span<Char>) Read(Span<Char>) Read(Span<Char>)
ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) 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(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken)
ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) 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>) ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>)
ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32) 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(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken)
ReadLine() ReadLine() ReadLine() 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() ReadLineAsync() ReadLineAsync() 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.

ReadToEnd() ReadToEnd() ReadToEnd() 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() ReadToEndAsync() ReadToEndAsync() 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.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implémentations d’interfaces explicites

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

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

(Inherited from TextReader)

S’applique à

Voir aussi