Exporter (0) Imprimer
Développer tout

File.AppendText, méthode

Mise à jour : novembre 2007

Crée StreamWriter qui ajoute du texte codé UTF-8 à un fichier existant.

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

public static StreamWriter AppendText(
	string path
)
public static StreamWriter AppendText(
	String path
)
public static function AppendText(
	path : String
) : StreamWriter

Paramètres

path
Type : System.String
Chemin d'accès du fichier dans lequel le texte est ajouté.

Valeur de retour

Type : System.IO.StreamWriter
StreamWriter qui ajoute du texte codé UTF-8 à un fichier existant.

ExceptionCondition
UnauthorizedAccessException

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

ArgumentException

path est une chaîne de longueur nulle, ne contient que des espaces blancs ou contient un ou plusieurs caractères non valides comme défini par InvalidPathChars.

ArgumentNullException

path a la valeur null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

Le format de path est non valide.

Cette méthode équivaut à la surcharge du constructeur StreamWriter(String, Boolean). Si le fichier spécifié par path n'existe pas, il est créé. Si le fichier existe, les opérations d'écriture dans StreamWriter ajoutent du texte au fichier. Les threads supplémentaires sont autorisés à lire le fichier pendant qu'il est ouvert.

Le paramètre path est autorisé à spécifier des informations sur le chemin d'accès relatif ou absolu. Les informations sur le chemin d'accès relatif sont interprétées comme étant relatives au répertoire de travail en cours. Pour obtenir le répertoire de travail en cours, consultez GetCurrentDirectory.

Le paramètre path ne respecte pas la casse.

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

L'exemple suivant ajoute du texte à un fichier.

using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        string path = @"c:\temp\MyTest.txt";
        // This text is added only once to the file.
        if (!File.Exists(path)) 
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path)) 
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }	
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        using (StreamWriter sw = File.AppendText(path)) 
        {
            sw.WriteLine("This");
            sw.WriteLine("is Extra");
            sw.WriteLine("Text");
        }	

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path)) 
        {
            string s = "";
            while ((s = sr.ReadLine()) != null) 
            {
                Console.WriteLine(s);
            }
        }
    }
}


import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        String path = "c:\\temp\\MyTest.txt";

        // This text is added only once to the file.
        if (!(File.Exists(path))) {
            // Create a file to write to.
            StreamWriter sw = File.CreateText(path);
            try {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
            finally {
                sw.Dispose();
            }
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        StreamWriter sw = File.AppendText(path);
        try {
            sw.WriteLine("This");
            sw.WriteLine("is Extra");
            sw.WriteLine("Text");
        }
        finally {
            sw.Dispose();
        }

        // Open the file to read from.
        StreamReader sr = File.OpenText(path);
        try {
            String s = "";
            while ((s = sr.ReadLine())!= null) {
                Console.WriteLine(s);
            }
        }
        finally {
            sr.Dispose();
        }
    } //main
} //Test


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

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

.NET Framework

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

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft