Reservierte Eigenschaften für MSBuild
MSBuild stellt eine Reihe reservierter Eigenschaften zum Speichern von Informationen über die Projektdatei und die MSBuild-Binärdateien bereit.Diese Eigenschaften werden auf dieselbe Weise wie andere MSBuild-Eigenschaften ausgewertet.Um z. B. die MSBuildProjectFile-Eigenschaft zu verwenden, geben Sie Folgendes ein:
$(MSBuildProjectFile)
Reservierte Eigenschaften
Die folgende Tabelle beschreibt die reservierten MSBuild-Eigenschaften.
Eigenschaft |
Beschreibung |
|---|---|
MSBuildBinPath |
Der absolute Pfad des Ordners, in dem die MSBuild Binärdateien, die verwendet werden, lokalisiert werden (beispielsweise, C:\Windows\Microsoft.Net\Framework\Versionsnummer\).Diese Eigenschaft ist nützlich, wenn Sie auf Dateien im Verzeichnis MSBuild verweisen müssen. |
MSBuildExtensionsPath |
Pfad von MSBuild-Unterordners im Ordner \Programme\ oder \Programme (x86)\, abhängig von der Bitanzahl des aktiven Fensters.Beispielsweise denn 32-Bit Fenster auf 64-Bit Computer, Pfad zeigt zu \Programme (x86)\.Ein 64-Bit-Fenster auf einem 64-Bit-Computer, verweist der Pfad auf den Ordner \Programme\.Siehe auch MSBuildExtensionsPath32 und MSBuildExtensionsPath64. Dieser Speicherort ist nützlich zum Ablegen benutzerdefinierter Zieldateien.Beispielsweise könnten die Zieldateien an \Programme\\MSBuild\MyFiles\Northwind.targets installiert und in Projektdateien dann importiert werden, indem Sie diesen XML-Code verwendeten: <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/> .gif "Hinweis") Hinweis
Sie können die Umgebungsvariable MSBUILDLEGACYEXTENSIONSPATH zu einem Wert ungleich null angibt festlegen, um das Verhalten von MSBuildExtensionsPath in früheren Versionen zu aktivieren.
|
MSBuildExtensionsPath32 |
Pfad des MSBuild-Unterordners im Ordner \Programme\ oder \Programme (x86)\.Dieses Pfad zeigt immer auf den 32-Bit-Ordner \Programme\ auf 32-Bit Computer und auf \Programme (x86)\ auf einem 64-Bit-Computer.Siehe auch MSBuildExtensionsPath und MSBuildExtensionsPath64. |
MSBuildExtensionsPath64 |
Der Pfad des MSBuild-Unterordners im Ordner \Programme\.Für einen 64-Bit-Computer zeigt dieser Pfad immer auf den Ordner \Programme\.Für einen 32-Bit-Computer ist dieser Pfad leer.Siehe auch MSBuildExtensionsPath und MSBuildExtensionsPath32. |
MSBuildLastTaskResult |
true wenn die vorherige Aufgabengruppe ohne Fehler (selbst wenn Warnungen hat) oder false, wenn die vorherige Aufgabe Fehler hatte. Hinweis
In der Regel wenn ein Fehler in einer Aufgabe auftritt, ist der Fehler das letzte Element, die in diesem Projekt geschieht.Daher ist der Wert dieser Eigenschaft nie false, außer in diese Szenarien:
|
MSBuildNodeCount |
Die maximale Anzahl von gleichzeitigen Prozessen, die beim Erstellen verwendet werden.Dies ist der dieser Wert von angegeben /maxcpucount für in der Befehlszeile.Wenn Sie angegebenes /maxcpucount, ohne einen Wert angeben, dann MSBuildNodeCount anzugeben die Anzahl von Prozessoren im Computer.Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz und Paralleles Erstellen von mehreren Projekten mit MSBuild. |
MSBuildProgramFiles32 |
Der Speicherort des 32-Bit-Programmordners; beispielsweise C:\Program Files (x86). |
MSBuildProjectDefaultTargets |
Die vollständige Liste von Zielen, die im DefaultTargets-Attribut des Projekt-Elements angegeben ist.Beispielsweise würde die folgende Project-Element einen MSBuildDefaultTargets-Eigenschaftswert von A;B;C haben: <Project DefaultTargets="A;B;C" > |
MSBuildProjectDirectory |
Der absolute Pfad des Verzeichnisses, in dem die Projektdatei befindet; zum Beispiel C:\MyCompany\MyProduct\. |
MSBuildProjectDirectoryNoRoot |
Der Wert der - Eigenschaft MSBuildProjectDirectory, ausschließlich des Stammlaufwerks. |
MSBuildProjectExtension |
Die Dateinamenerweiterung der Projektdatei, einschließlich den Punkt; beispielsweise .proj. |
MSBuildProjectFile |
Der vollständige Dateiname der Projektdatei, einschließlich der Dateinamenerweiterung; beispielsweise MyApp.proj. |
MSBuildProjectFullPath |
Der absolute Pfad und der Dateiname der vollständige Projektdatei, einschließlich der Dateinamenerweiterung; zum Beispiel C:\MyCompany\MyProduct\MyApp.proj. |
MSBuildProjectName |
Der Dateiname der Projektdatei ohne Dateinamenerweiterung; beispielsweise MyApp. |
MSBuildStartupDirectory |
Der absolute Pfad des Ordners, in dem MSBuild aufgerufen wird.Wenn Sie diese Eigenschaft verwenden, können Sie alle unter einen bestimmten Zeitpunkt in einer Projektstruktur erstellen, ohne dirs.proj-Dateien in jedem Verzeichnis zu erstellen.Stattdessen haben Sie lediglich ein Projekt – z. B. c:\traversal.proj, wie hier gezeigt: Um an jeder Stelle in der Struktur zu erstellen, geben Sie Folgendes ein: |
MSBuildThisFile |
Der Dateinamen und Dateierweiterungsteil von MSBuildThisFileFullPath. |
MSBuildThisFileDirectory |
Der Verzeichnisteil von MSBuildThisFileFullPath. |
MSBuildThisFileDirectoryNoRoot |
Der Verzeichnisteil von MSBuildThisFileFullPath, ausschließlich des Stammlaufwerks. |
MSBuildThisFileExtension |
Der Dateinamenerweiterungsteil von MSBuildThisFileFullPath. |
MSBuildThisFileFullPath |
Der absolute Pfad des Projekts oder der Datei, die das Ziel enthält, das ausgeführt wird. Tipp
Die MSBuildThisFileFullPath-Eigenschaft kann die Spezifikation eines relativen Pfads in einer Zieldatei, die relativ zur Zieldatei und nicht relativ zu der Datei des ursprünglichen Projekts ist.
|
MSBuildThisFileName |
Der Dateinamenteil von MSBuildThisFileFullPath, ohne Dateinamenerweiterung. |
MSBuildToolsPath |
Der Installationspfad der MSBuild-Version, die mit dem Wert von MSBuildToolsVersion zugeordnet ist. |
MSBuildToolsVersion |
Die Version des MSBuild Toolsets, das verwendet wird, um das Projekt zu erstellen. Hinweis
Ein MSBuild Toolset besteht Aufgaben, Zielen und Tools, die verwendet werden, um eine Anwendung zu erstellen.Die Tools umfassen Compiler wie csc.exe und vbc.exe ein.Weitere Informationen finden Sie unter MSBuild-Toolset (ToolsVersion) und Standardmäßige und benutzerdefinierte Toolsetkonfigurationen.
|