StreamWriter, classe

StreamWriter est conçu pour la sortie de caractères dans un encodage particulier, tandis que les classes dérivées de Stream sont conçues pour l'entrée et la sortie d'octets.

Par défaut StreamWriter utilise une instance de UTF8Encoding, sauf spécification contraire. Étant donné que cette instance de UTF8Encoding est construite sans marque d'ordre d'octet, sa méthode GetPreamble retourne un tableau d'octets vide. Pour créer StreamWriter à l'aide de l'encodage UTF-8 et d'une marque d'ordre d'octet (BOM), pensez à utiliser un constructeur qui indique l'encodage, tel que StreamWriter(String, Boolean, Encoding).

Par défaut, StreamWriter n'est pas thread-safe. Consultez TextWriter.Synchronized pour plus d'informations sur un wrapper thread-safe.

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

L'exemple suivant montre comment employer un objet StreamWriter pour écrire un fichier qui répertorie les répertoires du lecteur C, puis utilise un objet StreamReader pour lire et afficher chaque nom de répertoire. Une méthode conseillée est d'utiliser ces objets dans une instruction using afin que les ressources non managées soient disposées correctement. L'instruction using appelle automatiquement Dispose sur l'objet lorsque le code qui l'utilise est terminé.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);

                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources