AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos
  • Condición de uso
  • Nivel de compresión
  • Códigos de error
  • Añadir un fichero que ya se encuentra en el archivo
  • Índice de ficheros en el archivo
Añade una lista de archivos (de cualquier tipo) a un archivo comprimido en formato ZIP, CAB, WDZ o 7z, TAR o TGZ (TAR.GZ) y lo comprime.. Esta función es más rápida que la ejecución de .AddFile para cada archivo.
Ejemplo
Reportes y Consultas
// Create an archive and add an element
// With progress bar displayed in a Progress Bar control
MyArchive is zipArchive
NumZipErr is int
 
NumZipErr = MyArchive.Create("C:\Doc\Archive\ArchiveFile.zip")
IF NumZipErr = 0 THEN
NumZipErr = MyArchive.AddFileList("C:\doc\Image\House.BMP" + CR +  ...
"C:\My Projects\WDStock\WDStock.wdp", zipDrive, PROGBAR_Progress)
IF NumZipErr <> 0 THEN
Error(zipMsgError(NumZipErr))
END
MyArchive.Close()
ELSE
Error(zipMsgError(NumZipErr))
END
Sintaxis

Añadir una lista de archivos (archivos separados por CR) Ocultar los detalles

<Result> = <Archive>.AddFileList(<Path of files to add> [, <Path section to store> [, <Progress>]])
<Result>: Integro
  • 0 si se realizó la suma,
  • Un código de error (valor superior a 0) en caso contrario. Para más detalles sobre estos códigos de error, consulte la página web de Observaciones.
<Archive>: Variable de tipo zipArchive
Nombre del zipArchive Variable correspondiente al archivo en el que se añadirán los ficheros.
<Path of files to add>: Cadena de caracteres
Nombre y ruta de los archivos a añadir en el archivo, separados por caracteres CR. Estas rutas pueden ser rutas completas o rutas relativas al directorio actual. El tamaño de cada ruta no debe superar los 260 caracteres..
El tamaño de cada archivo no debe exceder los 4 GB. De lo contrario, se produce un error.
No se pueden utilizar caracteres comodín.
Reportes y Consultas Este parámetro tiene la siguiente forma:
<File path> [ + TAB + <Path to store> ] + RC
Si se especifica la ruta a almacenar, la adición será equivalente a una adición de archivo seguida de una llamada a .ChangePath.
<Path section to store>: Constante opcional
Indica la sección de las rutas de los archivos que deben almacenarse en el archivo comprimido.. Este parámetro se tiene en cuenta para los ficheros para los que no se ha especificado .
zipDirectoryAlmacena los diferentes directorios encontrados en el fichero ruta así como el nombre del fichero y extension. Por ejemplo: \Directory\Files\NombreArchivo.pdf
zipDrive
(Valor predeterminado)
Almacenar la ruta completa y absoluta de archivo (nombre de disco, nombre de directorios, nombre de archivo y archivo extension). Por ejemplo: C:\Directory\Files\NombreArchivo.pdf
Para el formato ZIP: Esta constante no tiene ningún efecto.
Para el formato 7z: Esta constante y zipDirectory tendrán el mismo efecto
zipNoneAlmacena el nombre del archivo y extension. Por ejemplo: NombreDeArchivo.pdf

Si utiliza un archivo en formato .CAB, solo se tiene en cuenta la constante zipNone. De hecho, el formato.CAB no puede utilizarse para almacenar las rutas dentro del archivo.
<Progress>: Nombre de control o nombre de Procedure
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
Si usa un archivo TAR o TGZ (TAR.GZ) , la barra de progreso se actualiza solo después de agregar el archivo.

Añadiendo una lista de archivos encontrados en un array Ocultar los detalles

<Result> = <Archive>.AddFileList(<List of files> [, <Progress>])
<Result>: Integro
  • 0 si se realizó la suma,
  • Un código de error (valor superior a 0) en caso contrario. Para más detalles sobre estos códigos de error, consulte la página web de Observaciones.
<Archive>: Variable de tipo zipArchive
Nombre del zipArchive Variable correspondiente al archivo en el que se añadirán los ficheros.
<List of files>: Array de variables zipArchivedFile
Variables Array de zipArchivedFile utilizadas para conocer las características de los ficheros a añadir.
<Progress>: Nombre de control o nombre de Procedure
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
Si usa un archivo TAR o TGZ (TAR.GZ) , la barra de progreso se actualiza solo después de agregar el archivo.
Observaciones

Condición de uso

La adición de archivos en un archivo comprimido se puede realizar si:
  • El archivo existe (los archivos se crean con .Create).
  • El archivo es accesible en lectura/escritura.
  • El archivo es un archivo de una sola parte.
  • El tamaño del archivo es inferior a 4 GB.
Atención:
  • La ruta completa de cada archivo se almacena en los archivos en formato ZIP o WDZ.
  • Archivos en formato CAB: Los ficheros deben añadirse inmediatamente después de la creación del archivo.. Este formato no se puede utilizar para añadir archivos a un archivo comprimido existente.
  • Archivos en formato RAR: Esta función no está disponible.
  • Archivos en formato 7z: El archivo se comprime completamente cada vez que se llama .AddFileList.
El número máximo de archivos que se pueden incluir:
  • en un archivo WDZ: 232-1.
  • en un archivo ZIP: 65535.
  • en un archivo CAB: 65535.
Recordatorio:

    Nivel de compresión

    Los ficheros añadidos en un archivo zip son comprimidos por Default. El nivel de compresión de los ficheros añadidos a un archivo puede ser modificado por zipCompressionLevel.

    Códigos de error

    Se devuelven los siguientes códigos de error:
    • 1: La ruta pasada como parámetro no existe.
    • 2: Acceso denegado: el usuario no tiene suficientes derechos o el archivo se está utilizando actualmente. Si el archivo a insertar es un archivo de datos HFSQL, debe cerrarse con el siguiente código:
      HClose(<File name>)
      Multitask(<Timeout>) // Waits for the effective closing of the file
    • 3: El archivo está corrupto.
    • 4: La ruta no existe en el archivo.
    • 5: No se puede escribir en el archivo.
    • 7: El archivo ya se encuentra en el archivo.
    • 8: No se puede añadir un archivo comprimido a sí mismo. Por ejemplo, "MiArchivo" no puede añadirse a "MiArchivo".
    El mensaje correspondiente al código de error es devuelto por zipMsgError.

    Añadir un fichero que ya se encuentra en el archivo

    Se produce un error al añadir un fichero que ya se encuentra en el archivo comprimido.. Un fichero se identifica por su ruta almacenado. Por lo tanto, dos archivos con el mismo nombre y con el mismo relativo ruta no se pueden añadir a un archivo comprimido.

    Índice de ficheros en el archivo

    Cuando se añade un fichero a un archivo, se le asigna automáticamente un índice. Este índice corresponde al orden de inclusión de los ficheros en el archivo. Para seleccionar un fichero en el archivo comprimido, puede utilizar:
    • La índice del elemento (note: el índice de un elemento es devuelto por .FindFile).
    • La ruta almacenada del elemento.
    Componente: wd290zip.dll
    Versión mínima requerida
    • Versión 24
    Esta página también está disponible para…
    Comentarios
    Haga clic en [Agregar] para publicar un comentario

    Última modificación: 22/06/2023

    Señalar un error o enviar una sugerencia | Ayuda local