Eigenschaftenliste und Eigenschaften

Im optionalen Abschnitt für die Eigenschaftenliste können Sie Variablen (oder "Eigenschaften") definieren und zuweisen, die im Folgenden in der Konfigurationsdatei verwendet werden können. In diesem Abschnitt definierte Eigenschaftendefinitionen werden als "interne" Eigenschaften bezeichnet.

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

Sie können in der Konfigurationsdatei auch Variablen ("Eigenschaftenverweise") verwenden, die in diesem Abschnitt nicht definiert wurden. Beispielsweise werden sie auf der Befehlszeile definiert oder von der Umgebung übernommen.

Für Eigenschaften wird die Zeichenfolgenersetzung verwendet, wobei der einer Eigenschaft zugeordnete Wert anhand des folgenden Algorithmus gesucht wird:

1. Die externe Eigenschaftenliste wird nach einem Wert durchsucht.
2. Wenn dieser nicht gefunden werden kann, wird eine Umgebungsvariable gesucht, deren Name mit dem der Eigenschaft übereinstimmt.
3. Sofern auch diese Suche erfolglos bleibt, wird im Abschnitt "propertylist" der Konfigurationsdatei nach einer internen Definition gesucht.
4. Wenn auch dies zu keinem Ergebnis führt, wird eine leere Zeichenfolge als Wert verwendet.

Externe Eigenschaften werden an der Befehlszeile mit der Option –p übergeben. Es gibt drei integrierte externe Eigenschaften:

• applicationdir zum Angeben des Installationsverzeichnisses von Dotfuscator
• appdatadir zum Angeben des lokalen Datenverzeichnisses für Dotfuscator
• configdir zum Angeben des Verzeichnisses mit der Konfigurationsdatei

Eigenschaften sind beim Erstellen von Konfigurationsdateien nützlich, die als Vorlage für mehrere Projekte oder für unterschiedliche Versionen desselben Projekts fungieren, sowie für eine einfache Portabilität zwischen verschiedenen Buildumgebungen.

Mit der folgenden Syntax wird auf eine Eigenschaft verwiesen:

${property_name}

Bei Eigenschaftenverweisen wird die Groß- und Kleinschreibung beachtet. Folglich verweist ${MyProjectDir} auf eine andere Eigenschaft als ${myprojectdir}.

Eigenschaftenverweise können nicht an beliebiger Stelle in der Konfigurationsdatei verwendet werden. Derzeit können Eigenschaftenverweise nur im <file>-Element als Werte des dir-Attributs und des name-Attributs verwendet werden. Im Folgenden finden Sie eine Liste der Abschnitte, in denen das <file>-Element verwendet wird:

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

An anderen Stellen der Konfigurationsdatei werden Eigenschaftenverweise buchstabengetreu ausgewertet.

Eigenschaftenverweise können nicht geschachtelt werden. Eine Schachtelung führt zu einem Fehler.

Im Folgenden finden Sie ein Beispiel für die Verwendung eines Eigenschaftenverweises:

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

© 2002-2007 PreEmptive Solutions. Alle Rechte vorbehalten.