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 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 |
