Freigeben über


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"/>

HinweisHinweis
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.

HinweisHinweis
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:

<Project ...>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

Um an jeder Stelle in der Struktur zu erstellen, geben Sie Folgendes ein:

msbuild c:\traversal.proj

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.

TippTipp
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.

HinweisHinweis
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.

Siehe auch

Konzepte

MSBuild-Eigenschaften

Weitere Ressourcen

MSBuild-Referenz