File.AppendAllText Méthode

Référence

Définition

Espace de noms:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

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, String, Encoding)	Ajoute la chaîne spécifiée au fichier en utilisant l’encodage spécifié, en créant le fichier s’il n’existe pas.

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.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents);

public static void AppendAllText (string path, string contents);

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

static member AppendAllText : string * string -> unit

Public Shared Sub AppendAllText (path As String, contents As String)

Paramètres

path: String

Fichier auquel ajouter la chaîne spécifiée.

contents: String

Chaîne à ajouter au fichier.

Exceptions

ArgumentException

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

ArgumentNullException

path a la valeur null.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

path a spécifié un fichier en lecture seule.

ou - Cette opération n'est pas prise en charge sur la plateforme actuelle.
ou - path a spécifié un répertoire.
ou - L'appelant n'a pas l'autorisation requise.

NotSupportedException

path est dans un format non valide.

SecurityException

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

Exemples

L’exemple de code suivant illustre l’utilisation de la AppendAllText méthode 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 du texte est ajouté à celui-ci. Toutefois, le répertoire nommé temp sur le lecteur C doit exister pour que l’exemple se termine correctement.

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);
    }
}

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText)
        End If

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

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Remarques

Pour une chaîne et un chemin d’accès de fichier donnés, cette méthode ouvre le fichier spécifié, ajoute la chaîne à la fin du fichier, puis ferme le fichier. La fermeture du descripteur de fichier par cette méthode est garantie, même si des exceptions sont levées.

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

S’applique à

AppendAllText(String, String, Encoding)

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

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);

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

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

static member AppendAllText : string * string * System.Text.Encoding -> unit

Public Shared Sub AppendAllText (path As String, contents As String, encoding As Encoding)

Paramètres

path: String

Fichier auquel ajouter la chaîne spécifiée.

contents: String

Chaîne à ajouter au fichier.

encoding: Encoding

Encodage des caractères à utiliser.

Exceptions

ArgumentException

ArgumentNullException

path a la valeur null.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

path a spécifié un fichier en lecture seule.

ou - Cette opération n'est pas prise en charge sur la plateforme actuelle.
ou - path a spécifié un répertoire.
ou - L'appelant n'a pas l'autorisation requise.

NotSupportedException

path est dans un format non valide.

SecurityException

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

Exemples

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);
    }
}

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText, Encoding.UTF8)
        End If

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

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Remarques

Pour une chaîne et un chemin d’accès de fichier donnés, 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. La fermeture du descripteur de fichier par cette méthode est garantie, même si des exceptions sont levées.

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

S’applique à

File.AppendAllText Méthode

Définition

Surcharges

AppendAllText(String, String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

AppendAllText(String, String, Encoding)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Ressources supplémentaires