FileSystem.WriteAllBytes(String, Byte[], Boolean) Método

Definición

Escribe datos en un archivo binario.

public:
 static void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);
public static void WriteAllBytes (string file, byte[] data, bool append);
static member WriteAllBytes : string * byte[] * bool -> unit
Public Shared Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

Parámetros

file
String

Ruta de acceso y nombre del archivo en el que se va a escribir.

data
Byte[]

Datos que se van a escribir en el archivo.

append
Boolean

True para anexar el contenido del archivo; False para sobrescribir el contenido del archivo. El valor predeterminado es False.

Excepciones

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.

file es Nothing.

El archivo no existe.

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

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

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

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

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

En este ejemplo se anexa la matriz CustomerData de datos al archivo CollectedData.

My.Computer.FileSystem.WriteAllBytes(
  "C:\MyDocuments\CustomerData", CustomerData, True)

Comentarios

Si la ruta de acceso especificada, excepto el nombre de archivo, no es válida, se producirá una DirectoryNotFoundException excepción. Si la ruta de acceso es válida, pero el archivo no existe, se crea el archivo.

Nota

El WriteAllBytes método abre un archivo, escribe en él y, a continuación, lo cierra. El código que usa el WriteAllBytes método es más sencillo que el código que usa un BinaryWriter objeto . Sin embargo, si va a agregar datos a un archivo mediante un bucle , un BinaryWriter objeto puede proporcionar un mejor rendimiento porque solo tiene que abrir y cerrar el archivo una vez.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.FileSystem.WriteAllBytes método .

En Vea
Escribir en un archivo binario Cómo: Escribir en archivos binarios en Visual Basic

Se aplica a