TextReader Classe

Définition

Représente un lecteur capable de lire une série séquentielle de caractères.Represents a reader that can read a sequential series of characters.

public ref class TextReader abstract : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class TextReader : MarshalByRefObject, IDisposable
type TextReader = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextReader
Inherits MarshalByRefObject
Implements IDisposable
Héritage
Dérivé
Attributs
Implémente

Exemples

TextReader est une classe abstraite.The TextReader class is an abstract class. Par conséquent, vous ne l’instanciez pas dans votre code.Therefore, you do not instantiate it in your code. La StreamReader classe dérive de TextReader et fournit des implémentations des membres pour la lecture à partir d’un flux.The StreamReader class derives from TextReader and provides implementations of the members for reading from a stream. L’exemple suivant montre comment lire tous les caractères d’un fichier à l’aide de StreamReader.ReadAsync(Char[], Int32, Int32) la méthode.The following example shows how to read all the characters in a file by using the StreamReader.ReadAsync(Char[], Int32, Int32) method. Il vérifie si chaque caractère est une lettre, un chiffre ou un espace blanc avant d’ajouter le caractère à une instance StringBuilder de la classe.It checks whether each character is a letter, digit, or white space before adding the character to an instance of the StringBuilder class.

using System;
using System.Windows;
using System.IO;
using System.Text;

namespace WpfApplication
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click_1(object sender, RoutedEventArgs e)
        {
            string filename = @"C:\Example\existingfile.txt";
            char[] result;
            StringBuilder builder = new StringBuilder();

            using (StreamReader reader = File.OpenText(filename))
            {
                result = new char[reader.BaseStream.Length];
                await reader.ReadAsync(result, 0, (int)reader.BaseStream.Length);
            }
           
            foreach (char c in result)
            {
                if (char.IsLetterOrDigit(c) || char.IsWhiteSpace(c))
                {
                    builder.Append(c);
                }
            }
            FileOutput.Text = builder.ToString();
        }
    }
}
Imports System.Text
Imports System.IO

Class MainWindow

    Private Async Sub Button_Click_1(sender As Object, e As RoutedEventArgs)
        Dim filename As String = "C:\Example\existingfile.txt"
        Dim result() As Char
        Dim builder As StringBuilder = New StringBuilder()

        Using reader As StreamReader = File.OpenText(filename)
            ReDim result(reader.BaseStream.Length)
            Await reader.ReadAsync(result, 0, reader.BaseStream.Length)
        End Using

        For Each c As Char In result
            If (Char.IsLetterOrDigit(c) Or Char.IsWhiteSpace(c)) Then
                builder.Append(c)
            End If
            Next
        FileOutput.Text = builder.ToString()
    End Sub
End Class

Remarques

TextReaderest la classe de base abstraite StringReaderde StreamReader et, qui lit les caractères des flux et des chaînes, respectivement.TextReader is the abstract base class of StreamReader and StringReader, which read characters from streams and strings, respectively. Utilisez ces classes dérivées pour ouvrir un fichier texte afin de lire une plage de caractères spécifiée, ou pour créer un lecteur basé sur un flux existant.Use these derived classes to open a text file for reading a specified range of characters, or to create a reader based on an existing stream.

Important

Ce type implémente l'interface IDisposable.This type implements the IDisposable interface. Une fois que vous avez fini d’utiliser un type qui dérive de ce type, vous devez le supprimer directement ou indirectement.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Pour supprimer directement le type Dispose, appelez sa méthode dans un bloc try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Pour la supprimer indirectement, utilisez une construction de langage telle que using (dans C#) ou Using (dans Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Pour plus d’informations, consultez dispose et la section « utilisation d’un objet qui implémente IDisposable » IDisposable dans la rubrique de l’interface.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Notes pour les héritiers

Une classe dérivée doit implémenter au Peek() minimum Read() les méthodes et pour créer une instance TextReaderutile de.A derived class must minimally implement the Peek() and Read() methods to make a useful instance of TextReader.

Constructeurs

TextReader()

Initialise une nouvelle instance de la classe TextReader.Initializes a new instance of the TextReader class.

Champs

Null

Fournit un TextReader sans données à lire.Provides a TextReader with no data to read from.

Méthodes

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.

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.

(Hérité de MarshalByRefObject)
Dispose()

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

Dispose(Boolean)

Libère les ressources non managées utilisées par TextReader et libère éventuellement les ressources managées.Releases the unmanaged resources used by the TextReader 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.

(Hérité de Object)
GetHashCode()

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

(Hérité de 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.

(Hérité de MarshalByRefObject)
GetType()

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

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

(Hérité de MarshalByRefObject)
MemberwiseClone()

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

(Hérité de Object)
MemberwiseClone(Boolean)

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

(Hérité de MarshalByRefObject)
Peek()

Lit le caractère suivant sans modifier l'état du lecteur ou la source du caractère.Reads the next character without changing the state of the reader or the character source. Retourne le prochain caractère disponible sans le lire réellement à partir du flux lecteur.Returns the next available character without actually reading it from the reader.

Read()

Lit le caractère suivant à partir du lecteur de texte et avance la position d'un caractère.Reads the next character from the text reader and advances the character position by one character.

Read(Char[], Int32, Int32)

Lit un nombre maximal spécifié de caractères à partir du lecteur 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 reader and writes the data to a buffer, beginning at the specified index.

Read(Span<Char>)
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.

ReadAsync(Memory<Char>, CancellationToken)
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.

ReadBlock(Span<Char>)
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.

ReadBlockAsync(Memory<Char>, CancellationToken)
ReadLine()

Lit une ligne de caractères à partir du lecteur de texte et retourne les données sous forme de chaîne.Reads a line of characters from the text reader 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.

ReadToEnd()

Lit tous les caractères entre la position actuelle et la fin du lecteur de texte, puis les retourne sous forme d'une chaîne.Reads all characters from the current position to the end of the text reader and returns them as one 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.

Synchronized(TextReader)

Crée un wrapper thread-safe autour du TextReader spécifié.Creates a thread-safe wrapper around the specified TextReader.

ToString()

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

(Hérité de Object)

Implémentations d’interfaces explicites

IDisposable.Dispose()

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

S’applique à

Voir aussi