zipAddFileList (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

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

Condiciones de uso
Nivel de compresión
Códigos de error
Agregar un archivo que ya existe en el archivo comprimido
Índice de los archivos en el archivo comprimido

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

zipAddFileList (Función)

Agrega y comprime automáticamente una lista de archivos en un archivo ZIP, CAB, WDZ, 7z, TAR, gzip o TGZ (TAR.GZ). Utilizar esta función es más rápido que ejecutar la función zipAddFile en cada archivo.

Novedad versión 2025

Ahora se admite el formato gzip (extensión .gz).

Ejemplo

// Création d'une archive et ajout d'un élément
// Avec jauge affichée dans un champ Jauge 
MonArchive is zipArchive
NumErrZip is int

NumErrZip = zipCreate(MonArchive, "C:\Doc\Archive\ficArchive.zip")
IF NumErrZip = 0 THEN
	NumErrZip = zipAddFileList(MonArchive, "C:\doc\Image\Maison.BMP" + CR + ...
			"C:\Mes Projets\WDStock\WDStock.wdp", zipDrive, JAUGE_Progression)
	IF NumErrZip <> 0 THEN
		Error(zipMsgError(NumErrZip))
	END
	zipClose(MonArchive)
ELSE
	Error(zipMsgError(NumErrZip))
END

Sintaxis

Agregar una lista de archivos separados por retornos de carro (CR) Ocultar los detalles

<Result> = zipAddFileList(<Archive> , <Path of files to add> [, <Path section to store> [, <Progress>]])

<Result>: Entero

0 si se agregó la lista de archivos,
Un código de error (valor superior a 0) en caso contrario. Para obtener más información sobre los códigos de error, consulte las Observaciones.

<Archive>: Cadena de caracteres o variable de tipo zipArchive

Nombre del archivo comprimido al que se agregarán los archivos.
Este nombre puede corresponder a:
un nombre de archivo definido con la función zipOpen o zipCreate.
el nombre de una variable de tipo zipArchive.
Las variables de tipo zipArchive no están disponibles en Java.

<Path of files to add>: Cadena de caracteres

Nombre y ruta de los archivos que se agregarán al archivo comprimido, separados por retornos de carro (CR). Estas rutas pueden ser completas o relativas al directorio actual. La longitud de cada ruta no debe superar los 260 caracteres.
El tamaño de cada archivo no debe superar los 4 GB. De lo contrario, se produce un error.
No puede utilizar caracteres comodín.
Este parámetro tiene el siguiente formato:
<File path> [ + TAB + <Path to store> ] + RC
Si se especifica una ruta, la adición del archivo equivaldrá a llamar a la función zipAddFile seguido de la función zipChangePath.

<Path section to store>: Constante opcional

Indica la sección de ruta de archivo que se almacenará en el archivo comprimido. Este parámetro solo se tiene en cuenta para los archivos para los que no se ha especificado el parámetro <Path to store> .
zipDirectory Almacena los distintos directorios que forman parte de la ruta, así como el nombre y la extensión del archivo. Por ejemplo: \Directorio\Archivos\NombreArchivo.pdf
zipDrive
(Valor predeterminado) Almacena la ruta completa y absoluta del archivo (disco, directorios, nombre y extensión del archivo). Por ejemplo: C:\Directorio\Archivos\NombreArchivo.pdf
Formato ZIP: Esta constante no tiene ningún efecto.
Formato 7z: Esta constante y la constante zipDirectorio tienen el mismo efecto.
Esta constante no está disponible debido a que no hay raíz de unidad.
Esta constante tendrá el mismo efecto que la constante zipDirectory.
zipNone Almacena el nombre y la extensión del archivo. Por ejemplo: NombreArchivo.pdf

Si utiliza un archivo en formato .CAB, solo se tiene en cuenta la constante zipNone. El formato .CAB no permite almacenar rutas dentro del archivo.

<Progress>: Nombre del control o del procedimiento

Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso en una ventana. La barra de progreso muestra el estado de adición y compresión de los archivos.
el nombre de un procedimiento WLanguage. Para obtener más información sobre este procedimiento, consulte Parámetros del procedimiento utilizado por la función zipAddFileList.
Si utiliza un archivo TAR, gzip o TGZ (TAR.GZ), la barra de progreso solo se actualiza después de que se ha agregado cada archivo.
Este procedimiento debe ejecutarse en el lado del servidor.
Este parámetro no está disponible.

Agregar una lista de archivos contenidos en un array Ocultar los detalles

<Result> = zipAddFileList(<Archive> , <List of files> [, <Progress>])

<Result>: Entero

0 si se agregó la lista de archivos,
Un código de error (valor superior a 0) en caso contrario. Para obtener más información sobre los códigos de error, consulte las Observaciones.

<Archive>: Variable de tipo zipArchive

Nombre del archivo comprimido al que se agregarán los archivos.
Este nombre puede corresponder a:
un nombre de archivo definido con la función zipOpen o zipCreate.
el nombre de una variable de tipo zipArchive.
Las variables de tipo zipArchive no están disponibles en Java.

<List of files>: Array de variables de tipo zipArchivedFile

Array de variables de tipo zipArchivedFile que permiten identificar las características de los archivos que se van a agregar.

<Progress>: Nombre del control o del procedimiento

Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso en una ventana. La barra de progreso muestra el estado de adición y compresión de los archivos.
el nombre de un procedimiento WLanguage. Para obtener más información sobre este procedimiento, consulte Parámetros del procedimiento utilizado por la función zipAddFileList.
Si utiliza un archivo TAR, gzip o TGZ (TAR.GZ), la barra de progreso solo se actualiza después de que se ha agregado cada archivo.
Este procedimiento debe ejecutarse en el lado del servidor.

Observaciones

Condiciones de uso

Puede agregar archivos a un archivo comprimido si:

El archivo comprimido existe (los archivos comprimidos pueden crearse utilizando la función zipCreate).
El archivo es accesible en modo de lectura/escritura.
El archivo es 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 CAB: Los archivos deben agregarse inmediatamente después de la creación del archivo CAB. Este formato no permite agregar archivos a un archivo comprimido existente.
Archivos RAR: Esta función no está disponible.
Archivos 7z: El archivo se comprime completamente cada vez que se llama a la función zipAddFileList.

Número máximo de archivos permitidos:

en un archivo WDZ: 2³²-1.
en un archivo ZIP: 65535.
en un archivo CAB: 65535.

Recordatorio:

Solo los archivos ZIP, TAR, gzip y TGZ (TAR.GZ) están disponibles.
Solo los archivos ZIP están disponibles.
El formato CAB no está disponible.

Nivel de compresión

De forma predeterminada, los archivos que se agregan a un archivo zip se comprimen. Puede cambiar el nivel de compresión de los archivos agregados a un archivo comprimido utilizando la función zipCompressionLevel.

Códigos de error

Los códigos de error devueltos son los siguientes:

1: La ruta pasada como parámetro no existe.
2: Acceso denegado: El usuario no tiene permisos suficientes o el archivo está en uso.. Si el archivo que se va a agregar es un archivo de datos HFSQL, debe cerrarse mediante el siguiente código:
HClose(<File name>)
Multitask(<Timeout>) // Waits until the file is closed
3: El archivo comprimido está dañado.
4: La ruta no existe en el archivo comprimido.
5: No se puede escribir en el archivo comprimido.
7: El archivo ya existe en el archivo comprimido.
8: Un archivo comprimido no puede agregarse a sí mismo. Por ejemplo, "MiArchivo" no puede agregarse a "MiArchivo".

La función zipMsgError devuelve el mensaje que corresponde al código de error.

Agregar un archivo que ya existe en el archivo comprimido

Al agregar un archivo que ya se existe en un archivo comprimido, se genera un error. Un archivo se identifica por la ruta almacenada. Por lo tanto, dos archivos con el mismo nombre y con la misma ruta relativa no pueden añadirse a un archivo.

Índice de los archivos en el archivo comprimido

Cuando se agrega un archivo a un archivo comprimido, se le asigna un índice automáticamente. Este índice corresponde al orden en que se agregan los archivos al archivo comprimido. Para seleccionar un archivo en el archivo comprimido, puede utilizar:

El índice del elemento (este índice se obtiene mediante la función zipFindFile).
El camino almacenado del elemento.

Clasificación Lógica de negocio / UI: Lógica de negocio

Componente: wd300zip.dll

Ver también

Versión mínima requerida

Versión 9

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 05/06/2025

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