FileSystem.WriteAllBytes(String, Byte[], Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 al 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 una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
file es Nothing.
El archivo no existe.
Otro proceso usa el archivo o se produce un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
No hay suficiente memoria para escribir la cadena en el búfer.
El usuario carece de 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 |