Tableau du répertoire
Le tableau Répertoire spécifie la disposition du répertoire associé au produit. Chaque ligne du tableau indique un répertoire à la fois au niveau de la source et de la cible.
Le tableau de boîtes de dialogue contient les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Répertoire | Identificateur | O | N |
| Répertoire_Parent | Identificateur | N | O |
| DefaultDir | DefaultDir | N | N |
Colonnes
-
Répertoire
-
La colonne Répertoire contient un identificateur unique pour un répertoire ou un chemin d’accès du répertoire. Cette colonne peut contenir le nom d’une propriété définie sur le chemin d’accès complet d’un répertoire cible. Si cette colonne contient une propriété, le répertoire cible utilise le nom spécifié dans la colonne DefaultDir et le répertoire parent spécifié dans la colonne Répertoire_Parent.
Le répertoire source utilise systématiquement le nom spécifié dans la colonne DefaultDir et le répertoire parent spécifié dans la colonne Répertoire_Parent.
Si la colonne Répertoire_Parent est nulle ou égale à la valeur de la colonne Répertoire, la colonne Répertoire représente un répertoire cible racine. Un seul répertoire racine peut être spécifié dans le tableau Répertoire.
-
Répertoire_Parent
-
Cette colonne est une référence au répertoire parent du répertoire. Un enregistrement avec une colonne Répertoire_Parent nulle ou égale à la colonne Répertoire représente un répertoire racine. Le chemin d’accès complet du répertoire parent déterminé par référence dans la colonne Répertoire_Parent est une clé externe dans la colonne Répertoire. Par exemple, si un dossier présente un répertoire parent nommé PDIR, le répertoire parent PDIR est indiqué dans la colonne Répertoire_Parent de la ligne avec PDIR situé dans la colonne Répertoire.
-
DefaultDir
-
La colonne DefaultDir contient le nom du répertoire (localisable) situé sous le répertoire parent. Par défaut, il s’agit du nom des répertoires cible et source. Pour spécifier différents noms de répertoires source et cible, séparez les noms cible et source par deux-points de la manière suivante : [nom_cible]:[nom_source].
Si la valeur de la colonne Répertoire_Parent est nulle ou égale à la colonne Répertoire, la colonne DefaultDir spécifie le nom d’un répertoire source racine.
Pour un répertoire source non racine, un point (.) inséré dans la colonne DefaultDir pour le nom du répertoire source ou cible indique une localisation du répertoire dans son répertoire parent sans sous-répertoire.
Les noms de répertoires de cette colonne peuvent formatés sous forme de paires nom du fichier court / nom du fichier long.
Notes
Chaque enregistrement du tableau représente un répertoire dans les images source et de destination. Le tableau Répertoire doit spécifier un répertoire racine unique accompagné d’une valeur de colonne Répertoire égale à la propriété TARGETDIR.
Pour une installation administrative, installez l’image administrative dans le répertoire racine nommé TARGETDIR et utilisez les noms de répertoires sources afin de déterminer les répertoires cibles.
Notez que le programme d’installation définit un certain nombre de propriétés standard sur les chemins d’accès aux dossiers du système. Pour obtenir la liste des propriétés définies sur les dossiers système, consultez la référence de propriété.
La résolution de répertoires est effectuée durant l’action CostFinalize et s’effectue comme suit :
Répertoire racine de destination
Un seul répertoire racine de destination peut exister. Pour spécifier le répertoire racine de destination, définissez la colonne Répertoire sur la propriété TARGETDIR et la colonne DefaultDir sur la propriété SourceDir. Si la propriété TARGETDIR est définie, le répertoire de destination est déterminé avec la valeur de la propriété. Si la propriété TARGETDIR n’est pas définie, la propriété ROOTDRIVE est utilisée pour déterminer le chemin.
Répertoire racine de la source
La valeur de la colonne DefaultDir associée à l’entrée du répertoire racine doit être définie sur la propriété SourceDir.
Répertoires non-racines de destination
La valeur Répertoire associée à un répertoire non-racine est également considérée comme le nom d’une propriété définissant l’emplacement de la destination. Si la propriété est définie, le répertoire de destination est déterminé avec la valeur de la propriété. Si la propriété n’est pas définie, le répertoire de destination est déterminé dans un sous-répertoire situé sous le répertoire de destination déterminé pour l’entrée Répertoire_Parent. La valeur DefaultDir définit le nom du sous-répertoire.
Répertoires non-racines de la source
Le répertoire source d’un répertoire non-racine est déterminé dans un sous-répertoire du répertoire source résolu pour l’entrée Répertoire_Parent. La valeur DefaultDir définit le nom du sous-répertoire.
Noms de fichiers courts ou longs
Lors de la résolution des répertoires de destination, les noms de fichiers courts spécifiés dans la colonne DefaultDir sont utilisés si la propriété SHORTFILENAMES est définie ou si le volume contenant le répertoire ne prend pas en charge les noms de fichiers longs. Sinon, le nom du fichier long est utilisé.
Notez que lors de la résolution des répertoires durant l’action CostFinalize, les clés du tableau Répertoire deviennent des propriétés définies sur les chemins d’accès au répertoire.
Pour créer des dossiers vides lors d’une installation, consultez Tableau CreateFolder.
Utilisation du tableau Répertoire
Si vous souhaitez plus d’informations concernant le tableau Répertoire, accompagné d’exemples, consultez Utilisation du tableau Répertoire.
Validation
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour