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
| Nombre | Description |
|---|---|
| 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 al 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 una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
file es Nothing.
El archivo no existe.
Otro proceso usa el archivo o se produce un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
No hay suficiente memoria para escribir la cadena en el búfer.
El usuario carece de 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.txty se sobrescribe cualquier texto existente del 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, consulte 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 |
| Anexar texto a un archivo | Cómo: Anexar a archivos de texto |
Consulte también
- Encoding
- WriteAllText(String, String, Boolean)
- Objetos (Visual Basic)
- Writing to Files in 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 al contenido del archivo; False para sobrescribir el contenido del archivo. El valor predeterminado es False.
- encoding
- Encoding
Qué codificación se va a usar al escribir en el archivo. El valor predeterminado es UTF-8.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
file es Nothing.
El archivo no existe.
Otro proceso usa el archivo o se produce un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
No hay suficiente memoria para escribir la cadena en el búfer.
El usuario carece de 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.txty se sobrescribe cualquier texto existente del 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, consulte 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 |
| Anexar texto a un archivo | Cómo: Anexar a archivos de texto |