FileSystem.WriteAllText Método

Definición

Escribe texto en un archivo.

Sobrecargas

WriteAllText(String, String, Boolean)

Escribe texto en un archivo.

WriteAllText(String, String, Boolean, Encoding)

Escribe texto en un archivo.

WriteAllText(String, String, Boolean)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Escribe texto en un archivo.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public static void WriteAllText (string file, string text, bool append);
static member WriteAllText : string * string * bool -> unit
Public Shared Sub WriteAllText (file As String, text As String, append As Boolean)

Parámetros

file
String

Archivo en el que se va a escribir.

text
String

Texto que se va a escribir en el archivo.

append
Boolean

True para anexar el contenido del archivo; False para sobrescribir el contenido del archivo.

Excepciones

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\); termina con una barra diagonal final.

file es Nothing.

El archivo no existe.

El archivo está en uso por otro proceso, o hay un error de E/S.

La ruta de acceso supera la longitud máxima definida por el sistema.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

No hay suficiente memoria para escribir la cadena en el búfer.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

En este ejemplo se escribe la línea "This is new text to be added." en el archivo Test.txt, sobrescribiendo cualquier texto existente en el archivo.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

En este ejemplo se escriben los nombres de los archivos de la Documents and Settings carpeta FileList.txten , insertando un retorno de carro entre cada uno para mejorar la legibilidad.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Comentarios

La codificación UTF-8 se usa para escribir en el archivo. Para especificar una codificación diferente, use una sobrecarga diferente del WriteAllText método .

Si el archivo especificado no existe, se crea.

Si la codificación especificada no coincide con la codificación existente del archivo, se omite la codificación especificada.

Nota

El WriteAllText método abre un archivo, escribe en él y, a continuación, lo cierra. El código que usa el WriteAllText método es más sencillo que el código que usa un StreamWriter objeto . Sin embargo, si va a agregar cadenas a un archivo mediante un bucle , un objeto puede proporcionar un StreamWriter mejor rendimiento porque solo tiene que abrir y cerrar el archivo una vez. Para obtener más información, vea el método OpenTextFileWriter.

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el My.Computer.FileSystem.WriteAllText método .

En Vea
Escribir texto en un archivo Cómo: Escribir texto en archivos en Visual Basic
Anexar texto a un archivo Cómo: Anexar a archivos de texto en Visual Basic

Consulte también

Se aplica a

WriteAllText(String, String, Boolean, Encoding)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Escribe texto en un archivo.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
static member WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Shared Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parámetros

file
String

Archivo en el que se va a escribir.

text
String

Texto que se va a escribir en el archivo.

append
Boolean

True para anexar el contenido del archivo; False para sobrescribir el contenido del archivo.

encoding
Encoding

Codificación que se usará al escribir en el archivo.

Excepciones

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\); termina con una barra diagonal final.

file es Nothing.

El archivo no existe.

El archivo está en uso por otro proceso, o hay un error de E/S.

La ruta de acceso supera la longitud máxima definida por el sistema.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

No hay suficiente memoria para escribir la cadena en el búfer.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

En este ejemplo se escribe la línea "This is new text to be added." en el archivo Test.txt, sobrescribiendo cualquier texto existente en el archivo.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

En este ejemplo se escriben los nombres de los archivos de la Documents and Settings carpeta FileList.txten , insertando un retorno de carro entre cada uno para mejorar la legibilidad.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Comentarios

Si el archivo especificado no existe, se crea.

Si la codificación especificada no coincide con la codificación existente del archivo, se omite la codificación especificada.

Nota

El WriteAllText método abre un archivo, escribe en él y, a continuación, lo cierra. El código que usa el WriteAllText método es más sencillo que el código que usa un StreamWriter objeto . Sin embargo, si va a agregar cadenas a un archivo mediante un bucle , un objeto puede proporcionar un StreamWriter mejor rendimiento porque solo tiene que abrir y cerrar el archivo una vez. Para obtener más información, vea el método OpenTextFileWriter.

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el My.Computer.FileSystem.WriteAllText método .

En Vea
Escribir texto en un archivo Cómo: Escribir texto en archivos en Visual Basic
Anexar texto a un archivo Cómo: Anexar a archivos de texto en Visual Basic

Consulte también

Se aplica a