zipAjouteFichier (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Fonctions de gestion des archives

Condition d'utilisation

Niveau de compression des archives ZIP ou 7z

Codes d'erreur

Ajout d'un fichier déjà présent dans l'archive

Indice des fichiers dans l'archive

Chemin mémorisé (archives au format WDZ et ZIP)

Jauge

Voir aussi

Constantes des fonctions d'archivage

Fonctions d'archivage (gestion des ZIP, WDZ, CAB, RAR, 7z, TAR et TGZ (TAR.GZ))

Les archives

Les archives mono-partie / multi-parties

zipAjouteListeFichier

zipExtraitListeFichier

zipNbPartieNécessaire

zipSupprimeListeFichier

zipSupprimeTout

zipTaille

zipTailleFichier

Condition d'utilisation
Niveau de compression des archives ZIP ou 7z
Codes d'erreur
Ajout d'un fichier déjà présent dans l'archive
Indice des fichiers dans l'archive
Chemin mémorisé (archives au format WDZ et ZIP)
Jauge

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

zipAjouteFichier (Fonction)

En anglais : zipAddFile

Ajoute et compresse automatiquement un fichier (de n'importe quel type) dans une archive de type CAB, ZIP, WDZ, 7z, TAR ou TGZ (TAR.GZ). Cette fonction n'est pas utilisable sur les archives de type RAR.

Pour ajouter les fichiers d'un répertoire, utilisez la fonction zipAjouteRépertoire.

Versions 15 et supérieures

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 15

Cette fonction est désormais disponible pour les applications Android.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction gère désormais le format 7z.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction gère désormais le format 7z.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction gère désormais le format 7z.

Versions 19 et supérieures

Cette fonction est désormais disponible en mode Windows Store apps.

Nouveauté 19

Cette fonction est désormais disponible en mode Windows Store apps.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction gère désormais les formats TAR ou TGZ (TAR.GZ).

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction gère désormais les formats TAR ou TGZ (TAR.GZ).

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Cette fonction gère désormais les formats TAR ou TGZ (TAR.GZ).

Exemple

Voir des exemples supplémentaires

// Création de l'archive
ResCréation = zipCrée("MonArchive", "C:\Temp\Archive.zip")
SI ResCréation = 0 ALORS
// Ajout d'un fichier dans une archive
ResAjoutFichier = zipAjouteFichier("MonArchive", ...
"C:\MonRépertoire\MesFichiers\Fichier.pdf", zipDisque)
FIN
// Affichage du message d'erreur si le fichier n'a pas été ajouté
SI ResAjoutFichier <> 0 ALORS
Erreur(zipMsgErreur(ResAjoutFichier))
FIN

// Création de l'archive
ResCréation = zipCrée("MonArchive", "\Temp\Archive.zip")
SI ResCréation = 0 ALORS
// Ajout d'un fichier dans une archive
ResAjoutFichier = zipAjouteFichier("MonArchive", ...
"\MonRépertoire\MesFichiers\Fichier.pdf", zipAucun)
FIN
// Affichage du message d'erreur si le fichier n'a pas été ajouté
SI ResAjoutFichier <> 0 ALORS
Erreur(zipMsgErreur(ResAjoutFichier))
FIN

Syntaxe

Ajouter un fichier en précisant la portion de chemin à mémoriser Masquer les détails

<Résultat> = zipAjouteFichier(<Archive> , <Chemin d'accès du fichier> [, <Portion du chemin à mémoriser> [, <Gestion de la jauge>]])

<Résultat> : Entier

0 si l'ajout a été effectué,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les remarques.

<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive

Nom de l'archive dans laquelle le fichier doit être ajouté.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
Versions 15 et supérieures
soit au nom d'une variable de type zipArchive.
Nouveauté 15
soit au nom d'une variable de type zipArchive.
soit au nom d'une variable de type zipArchive.

<Chemin d'accès du fichier> : Chaîne de caractères (avec guillemets)

Chemin d'accès du fichier à ajouter dans l'archive (260 caractères maximum). Ce chemin peut être un chemin complet ou relatif au répertoire en cours. Il n'est pas possible d'utiliser des caractères jokers (*, ?) dans le nom du fichier.
La taille de ce fichier doit être inférieure à 4 Go. Dans la cas contraire, une erreur est générée.
Le chemin d'accès au fichier est un chemin complet. En effet, il n'y a pas de notion de répertoire en cours sous Pocket PC.
Le chemin d'accès au fichier est un chemin complet ou relatif au répertoire de travail de l'application (connu avec la fonction fRepDonnées). Seuls les fichiers présents dans le répertoire de travail peuvent être ajoutés à l'archive.

<Portion du chemin à mémoriser> : Constante optionnelle

Indique la portion de chemin du fichier à mémoriser dans l'archive :
zipAucun Mémorise uniquement le nom et l'extension du fichier. Par exemple : NomFichier.pdf
zipRépertoire
(Valeur par défaut) Mémorise les différents répertoires composant le chemin, le nom et l'extension du fichier. Par exemple : \Répertoire\Fichiers\NomFichier.pdf
zipDisque Mémorise le chemin complet et absolu du fichier (nom du disque, des répertoires, du fichier et l'extension du fichier). Par exemple : C:\Répertoire\Fichiers\NomFichier.pdf
Pour le format ZIP : Cette constante n'a pas d'effet.
Pour le format 7z : Cette constante a le même effet que la constante zipRépertoire.
Cette constante n'est pas disponible car il n'y a pas de racine de lecteur.
Cette constante aura le même effet que la constante zipRépertoire.
Si vous manipulez une archive au format .CAB, seule la constante zipAucun est prise en compte. En effet, le format .CAB ne permet pas de stocker des chemins à l'intérieur de l'archive.
Ce paramètre n'est pas disponible : seuls le nom du fichier et son extension sont mémorisés.

<Gestion de la jauge> : Chaîne de caractères (avec ou sans guillemets)

Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Ce paramètre n'est pas disponible.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Ce paramètre n'est pas disponible.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Ce paramètre n'est pas disponible.

Non disponible

Ajouter un fichier en précisant le chemin à ignorer Masquer les détails

<Résultat> = zipAjouteFichier(<Archive> , <Chemin d'accès du fichier> [, <Portion du chemin à ignorer> [, <Gestion de la jauge>]])

<Résultat> : Entier

0 si l'ajout a été effectué,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive

Nom de l'archive dans laquelle le fichier doit être ajouté.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
Versions 15 et supérieures
soit au nom d'une variable de type zipArchive.
Nouveauté 15
soit au nom d'une variable de type zipArchive.
soit au nom d'une variable de type zipArchive.

<Chemin d'accès du fichier> : Chaîne de caractères (avec guillemets)

Chemin d'accès du fichier à ajouter dans l'archive (260 caractères maximum). Ce chemin peut être un chemin complet ou relatif au répertoire en cours. Il n'est pas possible d'utiliser des caractères jokers (*, ?) dans le nom du fichier.
La taille de ce fichier doit être inférieure à 4 Go. Dans la cas contraire, une erreur est générée.
Le chemin d'accès au fichier est un chemin complet. En effet, il n'y a pas de notion de répertoire en cours sous Pocket PC.

<Portion du chemin à ignorer> : Chaîne de caractères optionnelle (avec guillemets)

Indique la portion de chemin du fichier à ne pas conserver dans l'archive.
Par exemple, en WINDEV, si le chemin complet du fichier ajouté dans l'archive est : "C:\Mes Documents\Travail\Rapport.doc" et si le paramètre <Portion du chemin à ignorer> vaut "C:\Mes Documents\", seule la portion "Travail\Rapport.doc" sera mémorisée.

<Gestion de la jauge> : Chaîne de caractères (avec ou sans guillemets)

Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Ce paramètre n'est pas disponible.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Ce paramètre n'est pas disponible.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Ce paramètre n'est pas disponible.

Ajouter un fichier présent dans un buffer (format WDZ et ZIP uniquement) Masquer les détails

<Résultat> = zipAjouteFichier(<Archive> , <Fichier à ajouter> , <Gestion du buffer> , <Chemin à mémoriser> [, <Gestion de la jauge>])

<Résultat> : Entier

0 si l'ajout a été effectué,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive

Nom de l'archive dans laquelle le fichier doit être ajouté.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
Versions 15 et supérieures
soit au nom d'une variable de type zipArchive.
Nouveauté 15
soit au nom d'une variable de type zipArchive.
soit au nom d'une variable de type zipArchive.

<Fichier à ajouter> : Buffer

Buffer correspondant au contenu du fichier à ajouter dans l'archive.

<Gestion du buffer> : Constante

Mode de gestion du buffer :
zipEnMémoire Mémorise le contenu du buffer (c'est-à-dire le fichier) dans l'archive.

<Chemin à mémoriser> : Chaîne de caractères (avec guillemets)

Chemin du fichier ou nom du fichier associé au buffer et à mémoriser dans l'archive.

<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)

Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
La procédure doit être une procédure serveur.

Versions 15 et supérieures

Ajouter un fichier en utilisant une variable de type zipFichierArchivé Masquer les détails

<Résultat> = zipAjouteFichier(<Archive> , <Fichier> [, <Gestion de la jauge>])

<Résultat> : Entier

0 si l'ajout a été effectué,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive

Nom de l'archive dans laquelle le fichier doit être ajouté.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
soit au nom d'une variable de type zipArchive.

<Fichier> : Variable de type zipFichierArchivé

Nom de la variable de type zipFichierArchivé contenant toutes les informations sur le fichier à ajouter (y compris son contenu).
Il n'est pas nécessaire que le fichier existe sur le disque : seules les informations contenues dans ce paramètre sont prises en compte.

<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)

Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.

Nouveauté 15

Ajouter un fichier en utilisant une variable de type zipFichierArchivé Masquer les détails

<Résultat> = zipAjouteFichier(<Archive> , <Fichier> [, <Gestion de la jauge>])

<Résultat> : Entier

0 si l'ajout a été effectué,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive

Nom de l'archive dans laquelle le fichier doit être ajouté.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
soit au nom d'une variable de type zipArchive.

<Fichier> : Variable de type zipFichierArchivé

Nom de la variable de type zipFichierArchivé contenant toutes les informations sur le fichier à ajouter (y compris son contenu).
Il n'est pas nécessaire que le fichier existe sur le disque : seules les informations contenues dans ce paramètre sont prises en compte.

<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)

Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.

Ajouter un fichier en utilisant une variable de type zipFichierArchivé Masquer les détails

<Résultat> = zipAjouteFichier(<Archive> , <Fichier> [, <Gestion de la jauge>])

<Résultat> : Entier

0 si l'ajout a été effectué,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive

Nom de l'archive dans laquelle le fichier doit être ajouté.
Ce nom peut correspondre :
soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
soit au nom d'une variable de type zipArchive.

<Fichier> : Variable de type zipFichierArchivé

Nom de la variable de type zipFichierArchivé contenant toutes les informations sur le fichier à ajouter (y compris son contenu).
Il n'est pas nécessaire que le fichier existe sur le disque : seules les informations contenues dans ce paramètre sont prises en compte.

<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)

Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression du fichier manipulé.
au nom d'une procédure WLangage. Cette procédure est de la forme :

<Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement>)

où :
<Fichier en cours> correspond au nom du fichier en cours de traitement.
<Pourcentage d'avancement> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout du fichier.

Remarques

Condition d'utilisation

L'ajout de fichiers dans une archive ne peut être réalisé que si :

L'archive existe (la création d'une archive s'effectue avec la fonction zipCrée).
L'archive est accessible en lecture et en écriture.
L'archive est mono-partie.
La taille du fichier est inférieure à 4 Go.

Attention :

Archives au format CAB : L'ajout de fichiers doit se faire immédiatement après la création de l'archive. Ce format ne permet pas d'ajouter des fichiers dans une archive existante.
Archives au format 7z : L'archive est entièrement compressée à chaque appel de la fonction zipAjouteFichier. Cette fonction est conseillée lors de l'ajout d'un seul fichier. Si plusieurs fichiers doivent être ajoutés dans l'archive, utilisez la fonction zipAjouteListeFichier ou zipAjouteRépertoire.

Le nombre maximum de fichiers pouvant être intégrés :

dans un fichier WDZ : 2³²-1.
dans un fichier ZIP : 65535.
dans un fichier CAB : 65535.

Seules les archives au format ZIP sont disponibles.

Rappel :

Seules les archives au format ZIP, TAR ou TGZ (TAR.GZ) sont disponibles.
Seules les archives au format ZIP sont disponibles.

Niveau de compression des archives ZIP ou 7z

Par défaut, les fichiers ajoutés dans une archive au format ZIP ou 7z sont compressés. Il est possible de modifier le niveau de compression des fichiers ajoutés dans une archive grâce à la fonction zipNiveauCompression.

Codes d'erreur

Les codes d'erreur retournés sont les suivants :

1 : Le chemin passé en paramètre n'existe pas.
2 : Accès interdit : l'utilisateur n'a pas les droits nécessaires ou le fichier est en cours d'utilisation. Si le fichier à insérer est un fichier de données HFSQL, il doit être fermé avec le code suivant :

HFerme(NomFichier)
Multitâche() // Attend la fermeture effective du fichier
3 : L'archive est corrompue.
4 : Le chemin n'existe pas dans l'archive.
5 : Impossible d'écrire dans l'archive.
7 : Le fichier est déjà présent dans l'archive.
8 : Une archive ne peut pas être ajoutée à elle-même. Par exemple, l'archive "MonArchive" ne peut pas être ajoutée à l'archive "MonArchive".

Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.

Ajout d'un fichier déjà présent dans l'archive

L'ajout d'un fichier déjà présent dans une archive provoque une erreur. Un fichier est identifié selon son chemin mémorisé. Il est donc impossible d'ajouter à l'archive deux fichiers de même nom ayant le même chemin relatif.

Par exemple, l'ajout de deux fichiers de même noms issus de répertoires différents avec la constante zipAucun est impossible.

Indice des fichiers dans l'archive

Lors de l'ajout d'un fichier dans une archive, un indice est automatiquement attribué au fichier. Cet indice correspond à l'ordre d'intégration des fichiers dans l'archive. Pour sélectionner un fichier de l'archive, il est possible d'utiliser :

soit l'indice de l'élément (remarque : l'indice d'un élément peut être connu grâce à la fonction zipChercheFichier).
soit le chemin mémorisé de l'élément.

Chemin mémorisé (archives au format WDZ et ZIP)

Le tableau ci-dessous présente les chemins mémorisés dans l'archive en fonction :

du chemin d'accès du fichier,
de la portion du chemin à mémoriser.

Le répertoire en cours est : "C:\Temp" :


Fonction zipAjouteFichier	Localisation du fichier	zipAucun	zipRépertoire	zipDisque
zipAjouteFichier ("Archi", "Fichier.txt")	C:\Temp\Fichier.txt	Fichier.txt	Fichier.txt	Fichier.txt
zipAjouteFichier ("Archi", "Donnée\Fichier.txt")	C:\Temp\Donnée\Fichier.txt	Fichier.txt	Donnée\Fichier.txt	Donnée\Fichier.txt
zipAjouteFichier ("Archi", "D:\Donnée\Fichier.txt")	D:\Donnée\Fichier.txt	Fichier.txt	Donnée\Fichier.txt	D:\Donnée\Fichier.txt

Remarque : Si la constante zipDisque est utilisée, le format WDZ mémorise le chemin complet du fichier (lettre du lecteur comprise) alors que le format ZIP ne mémorise pas la lettre du lecteur.

Il n'y a pas de répertoire en cours :


Fonction zipAjouteFichier	Localisation du fichier	zipAucun	zipRépertoire
zipAjouteFichier("Archi", "\Fichier.txt")	\Fichier.txt	Fichier.txt	Fichier.txt
zipAjouteFichier("Archi", "\Temp\Fichier.txt")	\Temp\Fichier.txt	Fichier.txt	Temp\Fichier.txt

Le disque n'est pas mémorisé dans le chemin de l'archive.

Le répertoire et le disque ne sont pas mémorisés dans le chemin de l'archive. Seuls le nom du fichier et son extension sont mémorisés.

Jauge

Sous Windows, pour visualiser la progression de l'ajout et de la compression des fichiers, branchez un événement sur le message JaugeCompactage (1174). A la réception de ce message, la variable _EVE.wParam contient le pourcentage du fichier déjà compressé.

Attention : Cet événement n'est pas supporté si l'appel à la fonction zipAjouteFichier est réalisé dans un thread secondaire.

Versions 21 et supérieures
A partir de la version 21, il est possible d'utiliser le paramètre <Gestion de la jauge> pour gérer la progression de l'ajout du fichier.

Nouveauté 21
A partir de la version 21, il est possible d'utiliser le paramètre <Gestion de la jauge> pour gérer la progression de l'ajout du fichier.

A partir de la version 21, il est possible d'utiliser le paramètre <Gestion de la jauge> pour gérer la progression de l'ajout du fichier.

Cas particulier : Archives au format 7z : La compression étant globale, le pourcentage de compression d'un seul fichier n'est pas connu (variable _EVE.wParam). Seule la variable _EVE.lParam qui contient l'avancement global est mise à jour.

Composantes

wd230zip.dll

wp230zip.dll

wd230java.jar

wd230zip.so

wd230android.jar

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/04/2018

Signaler une erreur ou faire une suggestion | Aide en ligne locale