Liste de propriétés et propriétés

La section facultative de la liste des propriétés permet la définition et l'assignation de variables (appelées « propriétés ») qui pourront être utilisées ultérieurement dans le fichier de configuration. Les propriétés définies dans cette section sont appelées propriétés « internes ».

<!-- define expandable properties -->
<!-- optional -->
<propertylist>
 <property name="projectname" value="myproject"/>
 <property name="projectdir" value="c:\myprojects"/>
</propertylist>

Des variables (« références de propriétés ») peuvent également être utilisées dans le fichier de configuration sans qu'il soit nécessaire de les définir dans cette section. Par exemple, elles peuvent être définies sur la ligne de commande ou provenir de l'environnement.

Les propriétés fonctionnent via la substitution de chaînes, à l'aide de l'algorithme suivant, qui recherche une valeur associée à la propriété :

1. Rechercher une valeur dans la liste des propriétés externes.
2. Si aucune valeur n'est trouvée, rechercher une variable d'environnement portant le même nom que la propriété.
3. Si aucune variable n'est trouvée, rechercher une définition interne dans la section propertylist du fichier de configuration.
4. Si aucune définition n'est trouvée, utiliser la chaîne vide comme valeur.

Les propriétés externes sont passées via la ligne de commande à l'aide de l'option –p. Il existe trois propriétés externes intégrées :

• « applicationdir », qui correspond au répertoire d'installation de Dotfuscator.
• « appdatadir », qui correspond au répertoire de données local de Dotfuscator.
• « configdir », qui correspond au répertoire dans lequel se trouve le fichier de configuration.

Les propriétés sont utiles pour créer des fichiers de configuration qui servent de modèles pour plusieurs projets ou pour différentes versions d'un même projet, ou encore à des fins de portabilité entre différents environnements.

Une propriété est référencée à l'aide de la syntaxe suivante :

${nom_propriété}

Les références de propriétés respectent la casse, de sorte que ${MyProjectDir} fait référence à une propriété différente de ${myprojectdir}.

Les références de propriétés ne peuvent pas être utilisées n'importe où dans le fichier de configuration. Actuellement, les références de propriétés peuvent uniquement être utilisées en tant que valeurs dans les attributs « dir » ou « name » de l'élément <file>. Voici la liste des sections qui utilisent l'élément <file> :

inputassembly	mapinput	mapoutput
output	tempdir	assembly
removalreport	transform	key
loadpaths	program	filelist

Une référence de propriété est interprétée littéralement dans tout autre emplacement du fichier de configuration.

Les références de propriétés ne peuvent pas être imbriquées. Les imbriquer provoque une erreur.

Voici un exemple de référence de propriété en cours d'utilisation :

<output> 
 <file dir="${testdir}\output"/>
</output>

© 2002-2007 PreEmptive Solutions. Tous droits réservés.