|
- 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
zipAjouteFichier (Fonction) En anglais : zipAddFile 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 Notes.
<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. <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. |
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. <Gestion de la jauge> : Chaîne de caractères (avec ou sans guillemets) Versions 21 et supérieuresMode de gestion de la jauge. Ce paramètre peut correspondre : 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é 21Mode de gestion de la jauge. Ce paramètre peut correspondre : 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 : 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.
Versions 15 et supérieures Nouveauté 15Remarques 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. 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.
Documentation également disponible pour…
|
|
|
| |
| Cliquez sur [Ajouter] pour publier un commentaire |
|
| |
|
| |
| |
| |
| |
| |
| |
| | |
| |