My.Computer.FileSystem.ReadAllBytes (Método)
Actualización: noviembre 2007
Devuelve el contenido de un archivo como una matriz de bytes.
' Usage
Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file)
' Declaration
Public Function ReadAllBytes( _
ByVal file As String _
) As Byte()
Parámetros
- file
String. Archivo que se va a leer. Obligatorio.
Valor devuelto
Byte, matriz que incluye el contenido del archivo.
Excepciones
Las condiciones siguientes pueden hacer que se produzca 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 ReadAllBytes del objeto My.Computer.FileSystem permite leer de un archivo binario. El contenido del archivo se devuelve como una matriz de bytes.
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.ReadAllBytes.
Para |
Vea |
|---|---|
Leer de un archivo binario. |
Ejemplo
Este ejemplo lee del archivo C:/Documents and Settings/selfportrait.jpg.
My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")
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
Referencia
My.Computer.FileSystem (Objeto)