StreamReader Classe

Définition

public ref class StreamReader : System::IO::TextReader

public class StreamReader : System.IO.TextReader

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

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

type StreamReader = class
    inherit TextReader

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

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

Public Class StreamReader
Inherits TextReader

Héritage

Object

TextReader

StreamReader

Héritage

Object

MarshalByRefObject

TextReader

StreamReader

Attributs

SerializableAttribute ComVisibleAttribute

Exemples

L’exemple suivant utilise une instance de lecture de StreamReader texte à partir d’un fichier. Le constructeur utilisé dans cet exemple n’est pas pris en charge pour une utilisation dans les applications du Windows Store.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Create an instance of StreamReader to read from a file.
            // The using statement also closes the StreamReader.
            using (StreamReader sr = new StreamReader("TestFile.txt"))
            {
                string line;
                // Read and display lines from the file until the end of
                // the file is reached.
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
        catch (Exception e)
        {
            // Let the user know what went wrong.
            Console.WriteLine("The file could not be read:");
            Console.WriteLine(e.Message);
        }
    }
}

Imports System.IO

Class Test
    Public Shared Sub Main()
        Try
            ' Create an instance of StreamReader to read from a file.
            Dim sr As StreamReader = New StreamReader("TestFile.txt")
            Dim line As String
            ' Read and display the lines from the file until the end 
            ' of the file is reached.
            Do
                line = sr.ReadLine()
                Console.WriteLine(Line)
            Loop Until line Is Nothing
            sr.Close()
        Catch E As Exception
            ' Let the user know what went wrong.
            Console.WriteLine("The file could not be read:")
            Console.WriteLine(E.Message)
        End Try
    End Sub
End Class

L’exemple suivant instancie un StreamReader objet et appelle sa ReadAsync méthode pour lire un fichier de façon asynchrone.

using System;
using System.IO;
using System.Threading.Tasks;

class Example
{
    static async Task Main()
    {
        await ReadAndDisplayFilesAsync();
    }

    static async Task ReadAndDisplayFilesAsync()
    {
        String filename = "TestFile1.txt";
        Char[] buffer;

        using (var sr = new StreamReader(filename)) {
            buffer = new Char[(int)sr.BaseStream.Length];
            await sr.ReadAsync(buffer, 0, (int)sr.BaseStream.Length);
        }

        Console.WriteLine(new String(buffer));
    }
}
// The example displays the following output:
//       This is the first line of text in a relatively short file.
//       This is the second line.
//       This is the third line.
//       This is the fourth and final line.

Imports System.IO
Imports System.Threading.Tasks

Module Example
    Public Sub Main()
        ReadAndDisplayFilesAsync()
    End Sub

    Private Async Sub ReadAndDisplayFilesAsync()
        Dim filename As String = "TestFile1.txt"
        Dim buffer() As Char
        
        Using sr As New StreamReader(filename)
            ReDim buffer(CInt(sr.BaseStream.Length))
            Await sr.ReadAsync(buffer, 0, CInt(sr.BaseStream.Length))
        End Using

        Console.WriteLine(New String(buffer))
    End Sub
End Module
' The example displays the following output:
'       This is the first line of text in a relatively short file.
'       This is the second line.
'       This is the third line.
'       This is the fourth and final line.

Remarques

StreamReader est conçu pour l’entrée de caractères dans un encodage particulier, tandis que la classe est conçue pour l’entrée et la Stream sortie d’octets. Permet StreamReader de lire des lignes d’informations à partir d’un fichier texte standard.

StreamReader est défini par défaut sur l’encodage UTF-8, sauf indication contraire, au lieu d’utiliser la page de codes ANSI pour le système actuel. UTF-8 gère correctement les caractères Unicode et fournit des résultats cohérents sur les versions localisées du système d’exploitation. Si vous obtenez l’encodage de caractère actuel à l’aide de la CurrentEncoding propriété, la valeur n’est pas fiable tant que la première Read méthode n’est pas terminée, car la détection automatique de codage n’est pas effectuée tant que le premier appel à une Read méthode n’est pas effectué.

Par défaut, un StreamReader thread n’est pas sécurisé. Consultez TextReader.Synchronized un wrapper thread-safe.

Les Read(Char[], Int32, Int32) surcharges de méthode et Write(Char[], Int32, Int32) de lecture et d’écriture du nombre de caractères spécifiés par le count paramètre. Il s’agit d’être distingués et BufferedStream.ReadBufferedStream.Writequi lisent et écrivent le nombre d’octets spécifiés par le count paramètre. Utilisez les méthodes uniquement pour la BufferedStream lecture et l’écriture d’un nombre intégral d’éléments de tableau d’octets.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches d’E/S courantes.

Voir aussi

• Encoding
• Stream
• StreamWriter
• 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
• Guide pratique pour lire et écrire dans un fichier de données nouvellement créé