FileSystemProxy.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)
Escribe texto en un archivo.
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append);public void WriteAllText (string file, string text, bool append);member this.WriteAllText : string * string * bool -> unitPublic 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. El valor predeterminado es False.
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 StreamWriter objeto puede proporcionar un 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 que implican el My.Computer.FileSystem.WriteAllText método .
| En | Vea |
|---|---|
| Escribir texto en un archivo | Procedimiento para escribir texto en archivos |
| Anexar texto a un archivo | Procedimiento para anexar a archivos de texto |
Consulte también
- Encoding
- WriteAllText(String, String, Boolean)
- Objetos (Visual Basic)
- Escribir en archivos en Visual Basic
Se aplica a
WriteAllText(String, String, Boolean, Encoding)
Escribe texto en un archivo.
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);member this.WriteAllText : string * string * bool * System.Text.Encoding -> unitPublic 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. El valor predeterminado es False.
- encoding
- Encoding
Codificación que se usará al escribir en el archivo. El valor predeterminado es UTF-8.
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 StreamWriter objeto puede proporcionar un 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 que implican el My.Computer.FileSystem.WriteAllText método .
| En | Vea |
|---|---|
| Escribir texto en un archivo | Procedimiento para escribir texto en archivos |
| Anexar texto a un archivo | Procedimiento para anexar a archivos de texto |
