Lire en anglais

Partager via


File.AppendAllText Méthode

Définition

Ajoute la chaîne spécifiée au fichier, en créant le fichier s’il n’existe pas déjà.

Surcharges

AppendAllText(String, ReadOnlySpan<Char>)

Ajoute la chaîne spécifiée au fichier, en créant le fichier s’il n’existe pas déjà.

AppendAllText(String, String)

Ouvre un fichier, ajoute la chaîne spécifiée au fichier, puis ferme le fichier. Si le fichier n’existe pas, cette méthode crée un fichier, écrit la chaîne spécifiée dans le fichier, puis ferme le fichier.

AppendAllText(String, ReadOnlySpan<Char>, Encoding)

Ajoute la chaîne spécifiée au fichier, en créant le fichier s’il n’existe pas déjà.

AppendAllText(String, String, Encoding)

Ajoute la chaîne spécifiée au fichier à l’aide de l’encodage spécifié, en créant le fichier s’il n’existe pas déjà.

AppendAllText(String, ReadOnlySpan<Char>)

Ajoute la chaîne spécifiée au fichier, en créant le fichier s’il n’existe pas déjà.

C#
public static void AppendAllText (string path, ReadOnlySpan<char> contents);

Paramètres

path
String

Fichier à ajouter.

contents
ReadOnlySpan<Char>

Caractères à écrire dans le fichier.

Exceptions

path est null.

path est vide.

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il se trouve sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

path spécifié un fichier en lecture seule.

-ou-

path spécifié un fichier masqué.

-ou-

path spécifié un répertoire.

-ou-

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

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

path est dans un format non valide.

Remarques

Étant donné une chaîne et un chemin d’accès au fichier, cette méthode ouvre le fichier spécifié, ajoute la chaîne à la fin du fichier à l’aide de l’encodage spécifié,

puis ferme le fichier. Le handle de fichier est garanti être fermé par cette méthode, même si des exceptions sont levées. La méthode crée le fichier

s’il n’existe pas, mais il ne crée pas de répertoires. Par conséquent, la valeur du paramètre path doit contenir des répertoires existants.

S’applique à

.NET 9
Produit Versions
.NET 9

AppendAllText(String, String)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Ouvre un fichier, ajoute la chaîne spécifiée au fichier, puis ferme le fichier. Si le fichier n’existe pas, cette méthode crée un fichier, écrit la chaîne spécifiée dans le fichier, puis ferme le fichier.

C#
public static void AppendAllText (string path, string contents);
C#
public static void AppendAllText (string path, string? contents);

Paramètres

path
String

Fichier à lequel ajouter la chaîne spécifiée.

contents
String

Chaîne à ajouter au fichier.

Exceptions

.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().

path est null.

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, le répertoire n’existe pas ou se trouve sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

path spécifié un fichier en lecture seule.

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

-ou-

path spécifié un répertoire.

-ou-

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

path est dans un format non valide.

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

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode AppendAllText pour ajouter du texte supplémentaire à la fin d’un fichier. Dans cet exemple, un fichier est créé s’il n’existe pas déjà, et le texte est ajouté à celui-ci. Toutefois, le répertoire nommé temp sur le lecteur C doit exister pour que l’exemple se termine correctement.

C#
using System;
using System.IO;
using System.Text;

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.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}

Remarques

Étant donné une chaîne et un chemin d’accès au fichier, cette méthode ouvre le fichier spécifié, ajoute la chaîne à la fin du fichier, puis ferme le fichier. Le handle de fichier est garanti être fermé par cette méthode, même si des exceptions sont levées.

La méthode crée le fichier s’il n’existe pas, mais il ne crée pas de répertoires. Par conséquent, la valeur du paramètre path doit contenir des répertoires existants.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

AppendAllText(String, ReadOnlySpan<Char>, Encoding)

Ajoute la chaîne spécifiée au fichier, en créant le fichier s’il n’existe pas déjà.

C#
public static void AppendAllText (string path, ReadOnlySpan<char> contents, System.Text.Encoding encoding);

Paramètres

path
String

Fichier à ajouter.

contents
ReadOnlySpan<Char>

Caractères à écrire dans le fichier.

encoding
Encoding

Encodage à appliquer à la chaîne.

Exceptions

path ou encoding est null.

path est vide.

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il se trouve sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

path spécifié un fichier en lecture seule.

-ou-

path spécifié un fichier masqué.

-ou-

path spécifié un répertoire.

-ou-

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

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

path est dans un format non valide.

Remarques

Étant donné une chaîne et un chemin d’accès au fichier, cette méthode ouvre le fichier spécifié, ajoute la chaîne à la fin du fichier à l’aide de l’encodage spécifié,

puis ferme le fichier. Le handle de fichier est garanti être fermé par cette méthode, même si des exceptions sont levées. La méthode crée le fichier

s’il n’existe pas, mais il ne crée pas de répertoires. Par conséquent, la valeur du paramètre path doit contenir des répertoires existants.

S’applique à

.NET 9
Produit Versions
.NET 9

AppendAllText(String, String, Encoding)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Ajoute la chaîne spécifiée au fichier à l’aide de l’encodage spécifié, en créant le fichier s’il n’existe pas déjà.

C#
public static void AppendAllText (string path, string contents, System.Text.Encoding encoding);
C#
public static void AppendAllText (string path, string? contents, System.Text.Encoding encoding);

Paramètres

path
String

Fichier à lequel ajouter la chaîne spécifiée.

contents
String

Chaîne à ajouter au fichier.

encoding
Encoding

Encodage de caractères à utiliser.

Exceptions

.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().

path est null.

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, le répertoire n’existe pas ou se trouve sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

path spécifié un fichier en lecture seule.

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

-ou-

path spécifié un répertoire.

-ou-

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

path est dans un format non valide.

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

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode AppendAllText pour ajouter du texte supplémentaire à la fin d’un fichier. Dans cet exemple, un fichier est créé s’il n’existe pas déjà, et le texte est ajouté à celui-ci. Toutefois, le répertoire nommé temp sur le lecteur C doit exister pour que l’exemple se termine correctement.

C#
using System;
using System.IO;
using System.Text;

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.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}

Remarques

Étant donné une chaîne et un chemin d’accès de fichier, cette méthode ouvre le fichier spécifié, ajoute la chaîne à la fin du fichier à l’aide de l’encodage spécifié, puis ferme le fichier. Le handle de fichier est garanti être fermé par cette méthode, même si des exceptions sont levées.

La méthode crée le fichier s’il n’existe pas, mais il ne crée pas de répertoires. Par conséquent, la valeur du paramètre path doit contenir des répertoires existants.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0