FileSystem.WriteAllText Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 -> unitPublic 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 |
