My.Computer.FileSystem.ReadAllText (Método)
Actualización: noviembre 2007
Devuelve el contenido de un archivo de texto como un objeto String.
' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
ByVal file As String, _
ByVal encoding As System.Text.Encoding _
) As String
Parámetros
file
String. Nombre y ruta de acceso del archivo que se debe leer. Obligatorio.encoding
System.Text.Encoding. Codificación de caracteres que utilizar al leer el archivo. Obligatorio. El valor predeterminado es UTF-8.
Valor devuelto
String que incluye el contenido del archivo.
Excepciones
Puede que el contenido del archivo no sea el esperado y que los métodos que leen el archivo produzcan un error.
Las condiciones siguientes pueden producir una excepción:
La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).
El nombre de archivo finaliza con una barra oblicua final (ArgumentException).
La ruta de acceso no es válida porque es Nothing (ArgumentNullException).
El archivo no existe (FileNotFoundException).
El archivo está en uso por otro proceso o hay un error de E/S (IOException).
La ruta supera la longitud máxima definida por el sistema (PathTooLongException).
Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).
No hay suficiente memoria para escribir la cadena en el búfer (OutOfMemoryException).
El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).
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.
Se puede especificar la codificación del archivo si el contenido de éste está en una codificación como ASCII o UTF-8. Si lee de un archivo con caracteres extendidos, tendrá que especificar la codificación del archivo.
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.
Tareas
La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.FileSystem.ReadAllText.
Para |
Vea |
|---|---|
Leer de un archivo de texto |
Ejemplo
Este ejemplo lee el contenido del archivo Test.txt , lo coloca en una cadena y, a continuación, lo muestra en un cuadro de mensaje.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
Este ejemplo lee el contenido del archivo ASCII Test.txt , lo coloca en una cadena y, a continuación, lo muestra en un cuadro de mensaje.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
System.Text.Encoding.ASCII)
MsgBox(reader)
Requisitos
Espacio de nombres:Microsoft.VisualBasic.MyServices
Clase:FileSystemProxy (proporciona acceso a FileSystem)
Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)
Disponibilidad por tipo de proyecto
Tipo de proyecto |
Disponible |
|---|---|
Aplicación para Windows |
Sí |
Biblioteca de clases |
Sí |
Aplicación de consola |
Sí |
Biblioteca de controles de Windows |
Sí |
Biblioteca de controles Web |
Sí |
Servicio de Windows |
Sí |
Sitio Web |
Sí |
Permisos
El permiso siguiente puede ser necesario:
Permiso |
Descripción |
|---|---|
Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted. |
Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.
Vea también
Tareas
Cómo: Leer texto de archivos con Streamreader (Visual Basic)
Solución de problemas: Leer y escribir en archivos de texto
Tutorial: Manipular archivos y directorios en Visual Basic
Conceptos
Referencia
My.Computer.FileSystem (Objeto)