MSBuild-Eigenschaften
Aktualisiert: November 2007
Eigenschaften sind Schlüssel/Wert-Paare, die zur Konfiguration von Builds verwendet werden können. Sie sind hilfreich, um Werte an Aufgaben zu übergeben, Bedingungen auszuwerten und Werte zu speichern, auf die in der gesamten Projektdatei verwiesen wird.
Definieren von und Verweisen auf Eigenschaften in einer Projektdatei
Eigenschaften werden deklariert, indem ein Element mit dem Namen der Eigenschaft als untergeordnetes Element eines PropertyGroup-Elements erstellt wird. Durch die folgende XML wird beispielsweise eine Eigenschaft mit dem Namen BuildDir erstellt, die den Wert Build aufweist.
<PropertyGroup>
<BuildDir>Build</BuildDir>
</PropertyGroup>
In der gesamten Projektdatei wird mit der Syntax $(PropertyName) auf Eigenschaften verwiesen. Auf die Eigenschaft im vorherigen Beispiel wird beispielsweise mit $(BuildDir) verwiesen.
Festlegen von Eigenschaften in der Befehlszeile
MSBuild ermöglicht es Ihnen, Eigenschaften mit dem Befehlszeilenschalter /property oder /p in der Befehlszeile festzulegen. Die in der Projektdatei festgelegten und von Umgebungsvariablen geerbten Eigenschaftenwerte werden durch die Eigenschaftenwerte überschrieben, die von der Befehlszeile empfangen werden.
Im folgenden Beispiel wird die Configuration-Eigenschaft auf DEBUG festgelegt.
MSBuild.exe MyProj.proj /p:Configuration=DEBUG
Reservierte Eigenschaften
MSBuild reserviert einige Eigenschaftennamen zum Speichern von Informationen über die Projektdatei und die MSBuild-Binärdateien. Auf diese Eigenschaften wird wie auf jede andere Eigenschaft mit der $-Notation verwiesen. Weitere Informationen finden Sie unter Gewusst wie: Verweisen auf den Namen oder Speicherort der Projektdatei und Reservierte Eigenschaften für MSBuild.
Umgebungsvariablen
Auf Umgebungsvariablen in Projektdateien kann auf die gleiche Weise verwiesen werden wie auf reservierte Eigenschaften. Um die PATH-Umgebungsvariable in der Projektdatei zu verwenden, verwenden Sie beispielsweise $(Path). Wenn das Projekt eine Eigenschaftendefinition enthält, die denselben Namen wie eine Umgebungsvariable hat, wird der Wert der Umgebungsvariablen von der Eigenschaft im Projekt überschrieben. Weitere Informationen finden Sie unter Gewusst wie: Verwenden von Umgebungsvariablen in einem Build.
Speichern von XML in Eigenschaften
Eigenschaften können beliebigen XML-Code enthalten, um die Übergabe von Werten an Aufgaben oder das Anzeigen von Protokollierungsinformationen zu unterstützen. Im folgenden Beispiel ist die ConfigTemplate-Eigenschaft mit einem Wert dargestellt, der XML und andere Eigenschaftenverweise enthält. MSBuild ersetzt die Eigenschaftenverweise durch die entsprechenden Eigenschaftenwerte. Eigenschaftenwerte werden von oben nach unten interpretiert. Folglich sollten $(MySupportedVersion), $(MyRequiredVersion) und $(MySafeMode) in diesem Beispiel bereits definiert sein.
<PropertyGroup>
<ConfigTemplate>
<Configuration>
<Startup>
<SupportedRuntime
ImageVersion="$(MySupportedVersion)"
Version="$(MySupportedVersion)"/>
<RequiredRuntime
ImageVersion="$(MyRequiredVersion)
Version="$(MyRequiredVersion)"
SafeMode="$(MySafeMode)"/>
</Startup>
</Configuration>
</ConfigTemplate>
</PropertyGroup>
Siehe auch
Aufgaben
Gewusst wie: Verwenden von Umgebungsvariablen in einem Build
Gewusst wie: Verweisen auf den Namen oder Speicherort der Projektdatei