Compartir a través de

FileSystemProxy.ReadAllText Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.MyServices
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

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

String

Un valor de tipo String que contiene el contenido del archivo.

Excepciones

ArgumentException

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.

ArgumentNullException

file es Nothing.

FileNotFoundException

El archivo no existe.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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

String

Un valor de tipo String que contiene el contenido del archivo.

Excepciones

ArgumentException

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.

ArgumentNullException

file es Nothing.

FileNotFoundException

El archivo no existe.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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