FileSystemProxy.ReadAllText Método

Definición

Devuelve el contenido de un archivo de texto como un objeto String.

Sobrecargas

ReadAllText(String)

Devuelve el contenido de un archivo de texto como un objeto String.

ReadAllText(String, Encoding)

Devuelve el contenido de un archivo de texto como un objeto String.

ReadAllText(String)

Devuelve el contenido de un archivo de texto como un objeto String.

public:
 System::String ^ ReadAllText(System::String ^ file);
public string ReadAllText (string file);
member this.ReadAllText : string -> string
Public Function ReadAllText (file As String) As String

Parámetros

file
String

Nombre y ruta de acceso al archivo que se va a leer.

Devoluciones

Un valor de tipo String que contiene 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 lee el contenido de Test.txt en una cadena y, a continuación, se muestra en un cuadro de mensaje.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

En este ejemplo se lee el contenido del archivo Test.txt ASCII en una cadena y, a continuación, se muestra en un cuadro de mensaje.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Comentarios

El método ReadAllText del objeto My.Computer.FileSystem permite leer de un archivo de texto. El contenido del archivo se devuelve como una cadena.

La codificación de archivos se puede especificar si el contenido del archivo está en una codificación como ASCII o UTF-8. Si está leyendo desde un archivo con caracteres extendidos, debe especificar la codificación de archivos mediante otra sobrecarga del ReadAllText método .

No tome ninguna decisión sobre el contenido del archivo basándose en su nombre. Por ejemplo, es posible que el archivo Form1.vb no sea un archivo de código fuente de Visual Basic. Compruebe todas las entradas antes de utilizar los datos en la aplicación.

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.ReadAllText método .

En Vea
Leer de un archivo de texto Cómo: Leer de archivos de texto

Consulte también

Se aplica a

ReadAllText(String, Encoding)

Devuelve el contenido de un archivo de texto como un objeto String.

public:
 System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);
public string ReadAllText (string file, System.Text.Encoding encoding);
member this.ReadAllText : string * System.Text.Encoding -> string
Public Function ReadAllText (file As String, encoding As Encoding) As String

Parámetros

file
String

Nombre y ruta de acceso al archivo que se va a leer.

encoding
Encoding

Codificación de caracteres que se usará al leer el archivo. El valor predeterminado es UTF-8.

Devoluciones

Un valor de tipo String que contiene 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 lee el contenido de Test.txt en una cadena y, a continuación, se muestra en un cuadro de mensaje.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

En este ejemplo se lee el contenido del archivo Test.txt ASCII en una cadena y, a continuación, se muestra en un cuadro de mensaje.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Comentarios

El método ReadAllText del objeto My.Computer.FileSystem permite leer de un archivo de texto. El contenido del archivo se devuelve como una cadena.

La codificación de archivos se puede especificar si el contenido del archivo está en una codificación como ASCII o UTF-8. Si está leyendo desde un archivo con caracteres extendidos, debe especificar la codificación de archivos.

No tome ninguna decisión sobre el contenido del archivo basándose en su nombre. Por ejemplo, es posible que el archivo Form1.vb no sea un archivo de código fuente de Visual Basic. Compruebe todas las entradas antes de utilizar los datos en la aplicación.

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.ReadAllText método .

En Vea
Leer de un archivo de texto Cómo: Leer de archivos de texto

Consulte también

Se aplica a