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.

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

Permisos

El permiso siguiente puede ser necesario.

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)

WriteAllBytes

Otros recursos

Escribir en archivos en Visual Basic