|
|
- Conditions d'utilisation
- Codes d'erreur
- Destination de l'archive
- Suppression de l'archive originale
- Espace réservé
- Ordre de découpage
- Nombre de parties
- Fermeture de l'archive
- Actions réalisables sur une archive multi-parties
<Variable zipArchive>.Découpe (Fonction) En anglais : <zipArchive variable>.Split Découpe une archive en plusieurs sous-archives d'une taille donnée.
Syntaxe
<Résultat> = <Archive>.Découpe(<Destination de l'archive> [, <Taille des sous-archives> [, <Suppression de l'archive originale> [, <Espace réservé> [, <Gestion de la jauge>]]]])
<Résultat> : Entier - 0 si l'archive a été découpée,
- 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> : Variable de type zipArchive Nom d'une variable de type zipArchive correspondant à l'archive à manipuler. <Destination de l'archive> : Chaîne de caractères Chemin complet de la nouvelle archive multi-parties (260 caractères maximum). Ce chemin doit contenir le nom de l'archive multi-parties à créer. Il est possible de spécifier le même chemin et nom que l'archive originale : l'archive originale sera écrasée par l'archive découpée. <Taille des sous-archives> : Entier optionnel Taille en octets des volumes à créer. La taille par défaut des sous-archives est égale à 1,4 Mo (1400*1024 octets). La taille minimale est égale à 300 Ko par sous-archive (300*1024 octets). <Suppression de l'archive originale> : Booléen optionnel - Vrai si l'archive originale doit être détruite pendant le découpage,
- Faux (valeur par défaut) si l'archive originale ne doit pas être détruite pendant le découpage.
<Espace réservé> : Entier optionnel Taille (en octets) d'un espace réservé à diminuer de la première sous-archive. La taille de la première sous-archive correspondra à : <Taille des sous-archives> - <Espace réservé>. <Gestion de la jauge> : Chaîne de caractères optionnelle
Remarques Conditions d'utilisation Le découpage d'une archive ne peut être réalisé que si : - L'archive existe (la création d'une archive s'effectue avec la fonction <Variable zipArchive>.Crée).
- L'archive est accessible en lecture et en écriture.
- L'archive est mono-partie.
Attention : - Archives au format "CAB" : Cette fonction n'est pas disponible.
- Archives au format "RAR" : Cette fonction n'est pas disponible.
- Archives au format "7z" : Cette fonction n'est pas disponible.
- Archives au format "TAR" et "TARGZ" : Cette fonction n'est pas disponible.
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.
- 3 : L'archive est corrompue.
- 6 : Les sous-archives ne sont pas dans l'ordre.
- 22 : Il est interdit de découper une archive au format zip en une seule partie.
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur. Destination de l'archive <Destination> doit correspondre à un support accessible en lecture et en écriture. Ce support peut être : - Un disque dur.
- Un lecteur de disquettes, un lecteur réseau, etc.
- Un lecteur réseau auquel une lettre de lecteur a été attribué. Il est impossible d'effectuer un découpage vers un lecteur UNC.
La destination est une disquette : Une boîte de dialogue demande automatiquement le changement de disquettes. Si le bouton "Annuler" de cette boîte de dialogue est utilisé, la fonction <Variable zipArchive>.Découpe renvoie l'erreur 3 : "L'archive découpée est corrompue (sa création n'est pas terminée), l'archive originale est intacte". Attention : Si le paramètre <Suppression de l'archive originale> est Vrai, l'archive originale et l'archive découpée sont toutes les deux corrompues. | | | Extension de l'archive multi-parties (format WDZ) | Extension de l'archive multi-parties (format ZIP) | Si l'extension de l'archive n'est pas précisée, l'extension par défaut de la première sous-archive sera .WDZ.
L'extension des autres sous-archives seront automatiquement rajoutées (".001" à ".999").
Par exemple : si <Destination> = "C:\MesArchives\ArchiveDécoupée.WDZ", l'archive sera découpée dans le répertoire "C:\MesArchives" de la manière suivante : - ArchiveDécoupée.WDZ
- ArchiveDécoupée.001
- ArchiveDécoupée.002
- ArchiveDécoupée.003
- ...
| Si l'extension de l'archive n'est pas précisée, l'extension par défaut de la première sous-archive sera .ZIP.
L'extension des autres sous-archives seront automatiquement rajoutées (".Z01" à ".Z99").
Par exemple : si <Destination> = "C:\MesArchives\ArchiveDécoupée.ZIP", l'archive sera découpée dans le répertoire "C:\MesArchives" de la manière suivante : - ArchiveDécoupée.ZIP
- ArchiveDécoupée.Z01
- ArchiveDécoupée.Z02
- ArchiveDécoupée.Z03
- ...
|
Suppression de l'archive originale Lorsque le paramètre <Suppression de l'archive originale> a pour valeur Vrai, le découpage entraîne la fermeture de l'archive originale ainsi que sa destruction au fur et à mesure du découpage. Remarques : - Pour minimiser l'espace disque nécessaire pour effectuer le découpage, configurez le paramètre <Suppression de l'archive originale> à Vrai. En effet, pour découper une archive de taille importante, l'espace disque nécessaire correspond à deux fois la taille de l'archive : une fois pour l'archive originale et une fois pour l'archive découpée.
- Ce paramètre doit être utilisé avec prudence. En effet, en cas de problème pendant le découpage, l'archive originale et l'archive découpée seront toutes les deux détruites. Si l'espace disque est suffisant, il est préférable de découper l'archive originale et de supprimer cette même archive originale par la suite.
Espace réservé La taille de la première sous-archive peut être plus petite que la taille des autres sous-archives. Il suffit d'indiquer la taille en octets à diminuer de la première sous-archive dans le paramètre <Espace réservé>. Par exemple, dans le cas d'une copie sur disquettes, il peut être utile que la première sous-archive n'occupe pas tout l'espace de la première disquette. Il est ainsi possible de conserver des fichiers existants sur la première disquette. La taille de la première sous-archive correspondra à : <Taille des sous-archives> - <Espace réservé>.
Remarque : La taille de la première sous-archive doit respecter la formule suivante : <Taille des sous-archives> - <Espace réservé> > 300 Ko. Par exemple, si la taille de chaque sous-archive est de 1,4 Mo, la taille de l'espace réservé ne peut pas dépasser 1,1 Mo. Ordre de découpage Lors du découpage d'une archive, l'ordre de découpage est le suivant : - Création de la sous-archive N (extension ".NNN-1" ou ".ZNN-1").
- ...
- Création de la sous-archive 2 (extension ".001" ou "Z01").
- Création de la sous-archive 1 (extension ".WDZ" ou "ZIP").
Par exemple, si une archive est découpée en 4 parties, 4 sous-archives seront construites. La quatrième sous-archive (extension ".003" ou "Z03") sera créée en premier. La première sous-archive (extension ".WDZ" ou ".ZIP") sera créée en dernier. Découpage d'une archive directement sur disquettes : La première disquette insérée contiendra la dernière sous-archive. Nombre de parties La fonction <Variable zipArchive>.NbPartieNécessaire permet de connaître le nombre de parties nécessaires au découpage de l'archive. La fonction zipNbPartie permet de connaître le nombre de sous-archives d'une archive multi-parties. Remarque : Le découpage d'une archive au format ZIP en une seule partie est interdit et provoque une erreur. Fermeture de l'archive Après utilisation de la fonction <Variable zipArchive>.Découpe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser les fonctions : Remarque : Si le paramètre <Suppression de l'archive originale> a pour valeur Vrai, l'archive originale est automatiquement fermée par le découpage. Actions réalisables sur une archive multi-parties Certaines fonctions d'archivage sont utilisables uniquement sur des archives mono-partie (ajout et suppression de fichiers, création d'un exécutable auto-extractible, ...). Pour effectuer ces opérations, il suffit de regrouper les sous-archives (fonction <Variable zipArchive>.Regroupe) pour obtenir une archive mono-partie. A partir d'une archive multi-parties, il est uniquement possible de : Composante : wd280zip.dll
Documentation également disponible pour…
|
|
|
|
|
|
|