File.AppendAllText Método

Definición

Anexa la cadena especificada al archivo y crea el archivo si aún no existe.Appends the specified string to the file, creating the file if it does not already exist.

Sobrecargas

AppendAllText(String, String)

Abre un archivo, le anexa la cadena especificada y, a continuación, cierra el archivo.Opens a file, appends the specified string to the file, and then closes the file. Si el archivo no existe, este método crea un archivo, escribe la cadena especificada en él y, a continuación, lo cierra.If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.

AppendAllText(String, String, Encoding)

Anexa la cadena especificada al archivo mediante la codificación especificada y crea el archivo si aún no existe.Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

AppendAllText(String, String)

Abre un archivo, le anexa la cadena especificada y, a continuación, cierra el archivo.Opens a file, appends the specified string to the file, and then closes the file. Si el archivo no existe, este método crea un archivo, escribe la cadena especificada en él y, a continuación, lo cierra.If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.

public:
 static void AppendAllText(System::String ^ path, System::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)

Parámetros

path
String

Archivo al que se va a anexar la cadena especificada.The file to append the specified string to.

contents
String

Cadena que se va a anexar al archivo.The string to append to the file.

Excepciones

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path es null.path is null.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, el directorio no existe o está en una unidad no asignada).The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

path especificó un archivo que es de solo lectura.path specified a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

O bien-or- path especificó un directorio.path specified a directory.

o bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

path está en un formato no válido.path is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del método AppendAllText para agregar texto adicional al final de un archivo.The following code example demonstrates the use of the AppendAllText method to add extra text to the end of a file. En este ejemplo, se crea un archivo si aún no existe y se le agrega texto.In this example, a file is created if it doesn't already exist, and text is added to it. Sin embargo, el directorio denominado temp en la unidad C debe existir para que el ejemplo se complete correctamente.However, the directory named temp on drive C must exist for the example to complete successfully.

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

Comentarios

Dada una cadena y una ruta de acceso de archivo, este método abre el archivo especificado, anexa la cadena al final del archivo y, a continuación, cierra el archivo.Given a string and a file path, this method opens the specified file, appends the string to the end of the file, and then closes the file. Se garantiza que el identificador de archivo está cerrado por este método, aunque se produzcan excepciones.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

El método crea el archivo si no existe, pero no crea nuevos directorios.The method creates the file if it doesn't exist, but it doesn't create new directories. Por lo tanto, el valor del parámetro path debe contener directorios existentes.Therefore, the value of the path parameter must contain existing directories.

Seguridad

FileIOPermission
para el acceso para escribir en un archivo o directorio.for access to write to a file or directory. Enumeración asociada: AppendAssociated enumeration: Append

AppendAllText(String, String, Encoding)

Anexa la cadena especificada al archivo mediante la codificación especificada y crea el archivo si aún no existe.Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

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);
static member AppendAllText : string * string * System.Text.Encoding -> unit

Parámetros

path
String

Archivo al que se va a anexar la cadena especificada.The file to append the specified string to.

contents
String

Cadena que se va a anexar al archivo.The string to append to the file.

encoding
Encoding

Codificación de caracteres que se utilizará.The character encoding to use.

Excepciones

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path es null.path is null.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, el directorio no existe o está en una unidad no asignada).The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

path especificó un archivo que es de solo lectura.path specified a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

o bien-or- path especificó un directorio.path specified a directory.

o bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

path está en un formato no válido.path is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del método AppendAllText para agregar texto adicional al final de un archivo.The following code example demonstrates the use of the AppendAllText method to add extra text to the end of a file. En este ejemplo, se crea un archivo si aún no existe y se le agrega texto.In this example, a file is created if it doesn't already exist, and text is added to it. Sin embargo, el directorio denominado temp en la unidad C debe existir para que el ejemplo se complete correctamente.However, the directory named temp on drive C must exist for the example to complete successfully.

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

Comentarios

Dada una cadena y una ruta de acceso de archivo, este método abre el archivo especificado, anexa la cadena al final del archivo usando la codificación especificada y, a continuación, cierra el archivo.Given a string and a file path, this method opens the specified file, appends the string to the end of the file using the specified encoding, and then closes the file. Se garantiza que el identificador de archivo está cerrado por este método, aunque se produzcan excepciones.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

El método crea el archivo si no existe, pero no crea nuevos directorios.The method creates the file if it doesn't exist, but it doesn't create new directories. Por lo tanto, el valor del parámetro path debe contener directorios existentes.Therefore, the value of the path parameter must contain existing directories.

Seguridad

FileIOPermission
para el acceso para escribir en un archivo o directorio.for access to write to a file or directory. Enumeración asociada: AppendAssociated enumeration: Append

Se aplica a