Método File.AppendAllText(String, String, Encoding) en C# con ejemplos

File.AppendAllText(String, String, Encoding) es un método de clase de archivo incorporado que se usa para agregar la string especificada al archivo dado usando la codificación especificada si ese archivo existe; de ​​lo contrario, se crea un nuevo archivo y luego se agrega.
 

Sintaxis:  

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

Parámetro: Esta función acepta dos parámetros que se ilustran a continuación:
 

• ruta: este es el archivo donde se agregarán los contenidos dados.
• contenido: este es el contenido especificado que se agregará al archivo.
• Codificación: esta es la codificación de caracteres especificada.

Excepciones:
 

• ArgumentException: la ruta es una string de longitud cero, contiene solo espacios en blanco o contiene uno o más caracteres no válidos según lo definido por InvalidPathChars.
• ArgumentNullException: la ruta es nula.
• PathTooLongException: la ruta, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
• DirectoryNotFoundException: la ruta especificada no es válida (por ejemplo, el directorio no existe o está en una unidad no asignada).
• IOException: se produjo un error de E/S al abrir el archivo.
• UnauthorizedAccessException: la ruta especificó un archivo que es de solo lectura. O esta operación no es compatible con la plataforma actual. O la ruta especifica un directorio. O la persona que llama no tiene el permiso requerido.
• NotSupportedException: la ruta tiene un formato no válido.
• SecurityException: la persona que llama no tiene el permiso necesario.

A continuación se muestran los programas para ilustrar el método File.AppendAllText(String, String, Encoding).
Programa 1: antes de ejecutar el siguiente código, se crea un archivo con algunos contenidos que se muestran a continuación:
 

// C# program to illustrate the usage
// of File.AppendAllText() method
 
// Using System, System.IO,
// System.Text and System.Linq namespaces
using System;
using System.IO;
using System.Text;
using System.Linq;
 
class GFG {
    // Main() method
    public static void Main()
    {
        // Creating a file
        string myfile = @"file.txt";
 
        // Adding extra texts
        string appendText = " is a CS portal." + Environment.NewLine;
        File.AppendAllText(myfile, appendText, Encoding.UTF8);
 
        // Opening the file to read from.
        string readText = File.ReadAllText(myfile);
        Console.WriteLine(readText);
    }
}

Ejecutando: 
 

mcs -out:main.exe main.cs
mono main.exe
GeeksforGeeks is a CS portal.

Después de ejecutar el código anterior, se muestra la salida anterior y el contenido del archivo se vuelve como se muestra a continuación:
 

Programa 2: Inicialmente, no se crea ningún archivo, pero el código siguiente crea un nuevo archivo y agrega los contenidos especificados.
 

// C# program to illustrate the usage
// of File.AppendAllText() method
 
// Using System, System.IO,
// System.Text and System.Linq namespaces
using System;
using System.IO;
using System.Text;
using System.Linq;
 
class GFG {
    // Main() method
    public static void Main()
    {
        // Creating a file
        string myfile = @"file.txt";
 
        // Checking the existence of file
        if (!File.Exists(myfile)) {
            // Creating a file with below content
            string createText = "GFG" + Environment.NewLine;
            File.WriteAllText(myfile, createText);
        }
 
        // Adding extra texts
        string appendText = " is a CS portal." + Environment.NewLine;
        File.AppendAllText(myfile, appendText, Encoding.UTF8);
 
        // Opening the file to read from.
        string readText = File.ReadAllText(myfile);
        Console.WriteLine(readText);
    }
}

Ejecutando: 
 

mcs -out:main.exe main.cs
mono main.exe
GFG
 is a CS portal.

Después de ejecutar el código anterior, se mostró el resultado anterior y se creó un nuevo archivo que se muestra a continuación: