Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

StreamWriter, constructeur (String)

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié sur le chemin d'accès spécifié, à l'aide de l'encodage et de la taille de mémoire tampon par défaut.

Espace de noms :  System.IO
Assembly :  mscorlib (dans mscorlib.dll)

public StreamWriter(
	string path
)

Paramètres

path
Type : System.String
Chemin d'accès complet du fichier dans lequel écrire. path peut être un nom de fichier.

ExceptionCondition
UnauthorizedAccessException

Accès refusé.

ArgumentException

path est une chaîne vide ("").

ou

path contient le nom d'un périphérique système (com1, com2, etc.).

ArgumentNullException

path est null.

DirectoryNotFoundException

Le chemin d'accès spécifié n'est pas valide, il se trouve par exemple sur un lecteur non mappé.

PathTooLongException

Le chemin ou le nom de fichier spécifié, ou les deux, dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins et les noms de fichiers ne doivent pas dépasser, respectivement, 248 et 260 caractères.

IOException

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes.

SecurityException

L'appelant n'a pas l'autorisation requise.

Comme ce constructeur crée un StreamWriter avec encodage UTF-8 sans BOM (Byte-Order Mark), 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).

Le paramètre path peut être un nom de fichier, notamment un fichier sur un partage de convention d'affectation de noms (UNC). Si le fichier existe, il est remplacé ; dans le cas contraire, un nouveau fichier est créé.

Le paramètre path n'est pas nécessairement un fichier enregistré sur disque, mais peut également être n'importe quelle partie d'un système qui prend en charge l'accès via des flux.

Remarque AttentionAttention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulier et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, il se peut que les caractères ne puissent pas être interprétés et provoquent la levée d'une exception.

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

L'exemple de code suivant illustre les constructeurs StreamWriter.


        public void CreateTextFile(string fileName, string textToAdd) 
        {
            string logFile = DateTime.Now.ToShortDateString()
                .Replace(@"/",@"-").Replace(@"\",@"-") + ".log";
			
            FileStream fs = new FileStream(fileName,
                FileMode.CreateNew, FileAccess.Write, FileShare.None);
			
            StreamWriter swFromFile = new StreamWriter(logFile);
            swFromFile.Write(textToAdd);
            swFromFile.Flush();
            swFromFile.Close();

            StreamWriter swFromFileStream = new StreamWriter(fs);
            swFromFileStream.Write(textToAdd);
            swFromFileStream.Flush();
            swFromFileStream.Close();

            StreamWriter swFromFileStreamDefaultEnc = 
                new System.IO.StreamWriter(fs, 
                System.Text.Encoding.Default);
            swFromFileStreamDefaultEnc.Write(textToAdd);
            swFromFileStreamDefaultEnc.Flush();
            swFromFileStreamDefaultEnc.Close();

            StreamWriter swFromFileTrue = 
                new StreamWriter(fileName,true);
            swFromFileTrue.Write(textToAdd);
            swFromFileTrue.Flush();
            swFromFileTrue.Close();
			
            StreamWriter swFromFileTrueUTF8Buffer = 
                new StreamWriter(fileName, 
                true, System.Text.Encoding.UTF8,512);
            swFromFileTrueUTF8Buffer.Write(textToAdd);
            swFromFileTrueUTF8Buffer.Flush();
            swFromFileTrueUTF8Buffer.Close();

            StreamWriter swFromFileTrueUTF8 = 
                new StreamWriter(fileName, true,
                System.Text.Encoding.UTF8);
            swFromFileTrueUTF8.Write(textToAdd);
            swFromFileTrueUTF8.Flush();
            swFromFileTrueUTF8.Close();

            StreamWriter swFromFileStreamUTF8Buffer = 
                new StreamWriter(fs, System.Text.Encoding.UTF8, 512);
            swFromFileStreamUTF8Buffer.Write(textToAdd);
            swFromFileStreamUTF8Buffer.Flush();
            swFromFileStreamUTF8Buffer.Close();
        }


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

Afficher:
© 2014 Microsoft