Este tema aún no ha recibido ninguna valoración - Valorar este tema

File.AppendText (Método)

.NET Framework 2.0

Otras versiones

Crea un objeto StreamWriter que anexa texto con codificación UTF8 a un archivo existente.

Espacio de nombres: System.IO
Ensamblado: mscorlib (en mscorlib.dll)

Sintaxis

C++

Copiar

public static StreamWriter AppendText (
	string path
)

Copiar

public static StreamWriter AppendText (
	String path
)

JScript

Copiar

public static function AppendText (
	path : String
) : StreamWriter

Parámetros

path: Ruta de acceso del archivo al que se va a anexar.

Valor devuelto

StreamWriter que anexa texto con codificación UTF8 a un archivo existente.

Excepciones

Tipo de excepción	Condición
UnauthorizedAccessException	El llamador no dispone del permiso requerido.
ArgumentException	path es una cadena de longitud cero, contiene sólo espacios en blanco o contiene uno o más caracteres no válidos, tal y como se definen en InvalidPathChars.
ArgumentNullException	path es referencia de objeto null (Nothing en Visual Basic).
PathTooLongException	La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, las rutas de acceso deben ser inferiores a 248 caracteres y los nombres de archivo deben ser inferiores a 260 caracteres.
DirectoryNotFoundException	La ruta de acceso especificada no es válida (por ejemplo, se encuentra en una unidad de red no asignada).
NotSupportedException	path tiene un formato no válido.

Comentarios

Este método es equivalente a la sobrecarga del constructor StreamWriter(String,Boolean). Si el archivo especificado por path no existe, se crea. Si el archivo existe, las operaciones de escritura en StreamWriter anexan texto al archivo. Se permite que otros subprocesos lean el archivo mientras está abierto.

El parámetro path puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual. Para obtener el directorio de trabajo actual, vea GetCurrentDirectory.

El parámetro path no distingue mayúsculas y minúsculas.

Para obtener un ejemplo de cómo utilizar este método, vea la sección Ejemplo. En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.

Para realizar esta operación...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto	Cómo: Escribir texto en un archivo
Leer de un archivo de texto	Cómo: Leer texto de un archivo

Ejemplo

En el siguiente ejemplo se anexa texto a un archivo.

C++

Copiar

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

Copiar

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

Seguridad de .NET Framework

FileIOPermission para anexar al archivo especificado. Enumeración asociada: FileIOPermissionAccess.Append.

Plataformas

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión