My.Computer.FileSystem.WriteAllBytes (Método)
Actualización: noviembre 2007
Escribe datos en un archivo binario.
' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
ByVal file As String, _
ByVal data As Byte(), _
ByVal append As Boolean _
)
Parámetros
file
String. Nombre y ruta de acceso del archivo donde se va a escribir. Obligatorio.data
Byte. Datos que se escriben en el archivo. Obligatorio.append
Boolean. Si se anexan o sobrescriben los datos. El valor predeterminado es False. Obligatorio.
Excepciones
Las condiciones siguientes pueden crear 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).
La ruta de acceso no es válida porque es Nothing o finaliza con una barra inversa (ArgumentNullException).
El parámetro file señala una ruta de acceso que no existe (FileNotFoundException o DirectoryNotFoundException).
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).
El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).
Comentarios
Si el parámetro append es True, anexa los datos al archivo; de lo contrario se sobrescriben los datos del archivo.
Si la ruta de acceso especificada, excepto el nombre de archivo, no es válida, se producirá una excepción DirectoryNotFoundException. Si la ruta de acceso es válida pero el archivo no existe, se crea el archivo.
Nota: |
---|
El método WriteAllBytes abre un archivo, escribe en él y, a continuación, lo cierra. El código que usa el método WriteAllBytes es más sencillo que el código que usa un objeto BinaryWriter. Sin embargo, si se están agregando datos a un archivo mediante un bucle, un objeto BinaryWriter puede ofrecer mejor rendimiento porque solamente tiene que abrir y cerrar el archivo una vez. |
Tareas
En la tabla siguiente se enumera un ejemplo de una tarea en la que interviene el método My.Computer.FileSystem.WriteAllBytes.
Para |
Vea |
---|---|
Escribir en un archivo binario. |
Ejemplo
Este ejemplo anexa la matriz de datos CustomerData al archivo de CollectedData.
My.Computer.FileSystem.WriteAllBytes _
("C:\MyDocuments\CustomerData", CustomerData, True)
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: Escribir en archivos binarios en Visual Basic
Referencia
My.Computer.FileSystem (Objeto)