Reservierte und bekannte Eigenschaften für MSBuild

MSBuild stellt eine Reihe vordefinierter Eigenschaften zum Speichern von Informationen über die Projektdatei und die MSBuild-Binärdateien bereit. Diese Eigenschaften werden auf dieselbe Weise ausgewertet wie andere MSBuild-Eigenschaften. Zum Verwenden der MSBuildProjectFile-Eigenschaft geben Sie beispielsweise $(MSBuildProjectFile) ein.

MSBuild verwendet die Werte in der folgenden Tabelle, um die reservierten und bekannten Eigenschaften vorzudefinieren. Reservierte Eigenschaften können nicht überschrieben werden, und die meisten bekannten Eigenschaften sollten nur in erweiterten Szenarien überschrieben werden.

Reservierte und bekannte Eigenschaften

In der folgenden Tabelle sind die vordefinierten MSBuild-Eigenschaften enthalten. Die Beispielspalte in der Tabelle bezieht sich auf die folgende Beispielprojektdatei, von der angenommen wird, dass sie sich unter C:\Source\Repos\ConsoleApp1\ConsoleApp1 befindet. Sie zeigt ein Beispiel für die Werte, die diese Eigenschaften beim Zugriff auf die Projektdatei aufweisen, wenn MSBuild ohne spezielle Befehlszeilenoptionen aufgerufen wird.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>
</Project>

Eigenschaft	Reserviert oder bekannt	Beschreibung	Beispiel
FrameworkSDKRoot	Bekannt	Pfad zum Stammordner für .NET Framework-Tools.	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\
InnerBuildProperty	Bekannt	Gibt den Eigenschaftennamen an, der die Builddimension zur Festlegung von Zielversionen definiert (gilt nur, wenn der aktuelle Build ein Graphbuild ist)	TargetFramework
InnerBuildPropertyValues	Bekannt	Gibt den Eigenschaftennamen an, der die möglichen Werte für die InnerBuildProperty enthält (gilt nur, wenn der aktuelle Build ein Graphbuild ist)	TargetFrameworks
IsGraphBuild	Bekannt	True, wenn es sich um einen Graphbuild handelt, d. h., die Option -graphBuild ist aktiviert. Diese Option bedeutet, dass MSBuild einen Projektgraph erstellt. Das Konstruieren eines Graphs beinhaltet das Identifizieren der Projektverweise, um Abhängigkeiten zu erstellen. Das Erstellen dieses Graphs beinhaltet den Versuch, Projektverweise vor den Projekten zu erstellen, die die Verweise enthalten. Dieses Vorgehen unterscheidet sich vom herkömmlichen MSBuild-Vorgehen.
MSBuildAssemblyVersion	Reserviert	Die Version der MSBuild-Assemblys, die zum Erstellen des Projekts verwendet wird.	17.0
MSBuildBinPath	Reserviert	Der absolute Pfad des Ordners, in dem sich die zurzeit verwendeten MSBuild-Binärdateien befinden (zum Beispiel C:\Windows\Microsoft.Net\Framework\<versionNummer>). Diese Eigenschaft ist nützlich, wenn Sie auf Dateien im MSBuild-Verzeichnis verweisen müssen. Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildDisableFeaturesFromVersion	Reserviert	Wird von MSBuild und Microsoft SDKs zum Verwalten von Änderungswellen verwendet.
MSBuildExtensionsPath	Bekannt	Seit .NET Framework 4 gibt es keinen Unterschied zwischen den Standardwerten von MSBuildExtensionsPath und MSBuildExtensionsPath32. Sie können die Umgebungsvariable MSBUILDLEGACYEXTENSIONSPATH auf einen Wert ungleich NULL festlegen, um das Verhalten des Standardwerts von MSBuildExtensionsPath in früheren Versionen zu ermöglichen. In .NET Framework 3.5 und niedriger verweist der Standardwert von MSBuildExtensionsPath auf den Pfad des MSBuild-Unterordners unter den Ordnern \Program Files\ oder \Program Files (x86), je nach Bitanzahl des aktuellen Prozesses. Bei einem 32-Bit-Prozess auf einem 64-Bit-Computer zeigt diese Eigenschaft beispielsweise auf den Ordner \Programme (x86) . Bei einem 64-Bit-Prozess auf einem 64-Bit-Computer zeigt diese Eigenschaft auf den Ordner \Programme. Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein. Dieser Speicherort ist nützlich zum Ablegen benutzerdefinierter Zieldateien. Ihre Zieldateien können beispielsweise unter \Programme\MSBuild\MyFiles\Northwind.targets installiert sein und dann mithilfe des folgenden XML-Codes in Projektdateien importiert werden: <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath32	Bekannt	Der Pfad zu dem MSBuild-Unterordner unter dem Ordner \Programme oder \Programme (x86) . Dieser Pfad führt stets zum 32-Bit-Ordner \Programme auf einem 32-Bit-Computer und zu \Programme (x86) auf einem 64-Bit-Computer. Siehe auch MSBuildExtensionsPath und MSBuildExtensionsPath64. Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath64	Bekannt	Der Pfad des MSBuild-Unterordners im Ordner \Programme. Bei einem 64-Bit-Computer zeigt dieser Pfad immer auf den Ordner \Programme. Bei einem 32-Bit-Computer ist dieser Pfad leer. Siehe auch MSBuildExtensionsPath und MSBuildExtensionsPath32. Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	C:\Program Files\MSBuild
MSBuildFileVersion	Reserviert	Die vierteilige Version der MSBuild-Assemblys, die zum Erstellen des Projekts verwendet wird.	17.4.0.46505
MSBuildFrameworkToolsPath	Bekannt	Der Pfad zu den .NET Framework-Tools, mit dem der aktuell ausgeführte MSBuild erstellt wurde, mit einem nachgestellten Schrägstrich.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath32	Bekannt	Der Pfad zur 32-Bit-Version der .NET Framework-Tools für die Frameworkversion, mit der das aktuell ausgeführte MSBuild erstellt wurde, mit einem nachgestellten Schrägstrich.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath64	Bekannt	Der Pfad zur 64-Bit-Version der .NET Framework-Tools für die Frameworkversion, mit der das aktuell ausgeführte MSBuild erstellt wurde, mit einem nachgestellten Schrägstrich.	C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\
MSBuildInteractive	Reserviert	Der Wert dieser Eigenschaft ist true, wenn MSBuild interaktiv ausgeführt wird, wodurch Benutzereingaben zugelassen werden. Diese Einstellung wird von der Befehlszeilenoption -interactive gesteuert.	false
MSBuildLastTaskResult	Reserviert	true, wenn die vorherige Aufgabe ohne Fehler (auch wenn Warnungen auftraten) abgeschlossen wurde, oder false, wenn bei der vorherigen Aufgabe Fehler aufgetreten sind. Wenn ein Fehler in einer Aufgabe auftritt, ist das Auftreten des Fehlers in der Regel das letzte Ereignis in dem jeweiligen Projekt. Daher ist der Wert dieser Eigenschaft niemals false, außer in diesen Szenarien: – Wenn für das ContinueOnError-Attribut des Aufgabenelements (MSBuild)WarnAndContinue (oder true) bzw. ErrorAndContinue festgelegt wird. – Wenn Target über ein OnError-Element (MSBuild) als untergeordnetes Element verfügt.	true
MSBuildNodeCount	Reserviert	Die maximale Anzahl nebenläufiger Prozesse, die beim Erstellen verwendet werden. Dies ist der Wert, den Sie in der Befehlszeile für -maxcpucount angegeben haben. Wenn Sie -maxcpucount ohne einen Wert angegeben haben, wird die Anzahl der Prozessoren im Computer durch MSBuildNodeCount angegeben. Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz sowie unter Paralleles Erstellen von mehreren Projekten mit MSBuild.	1
MSBuildOverrideTasksPath	Bekannt	Der Speicherort, an dem nach Dateien vom Typ .overridetasks gesucht werden soll. Diese können zum Bereitstellen benutzerdefinierter Versionen von Standardaufgaben verwendet werden. Weitere Informationen finden Sie unter MSBuild-Aufgaben. Schließen Sie den abschließenden umgekehrten Schrägstrich nicht in den Pfad ein.
MSBuildProgramFiles32	Reserviert	Der Speicherort des Ordners für 32-Bit-Programme, beispielsweise C:\Programme (x86) . Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	C:\Program Files (x86)
MSBuildProjectDefaultTargets	Reserviert	Die vollständige Liste der Ziele, die im DefaultTargets-Attribut des Project-Elements angegeben sind. Das folgende Project-Element würde beispielsweise über einen MSBuildDefaultTargets-Eigenschaftswert von A;B;C verfügen: <Project DefaultTargets="A;B;C" >	Build
MSBuildProjectDirectory	Reserviert	Der absolute Pfad des Verzeichnisses, in dem sich die Projektdatei befindet, beispielsweise C:\MyCompany\MyProduct. Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	C:\Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectDirectoryNoRoot	Reserviert	Der Wert der MSBuildProjectDirectory-Eigenschaft, ausschließlich des Stammlaufwerks. Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectExtension	Reserviert	Die Erweiterung der Projektdatei, einschließlich des Punkts, z.B. .proj.	.csproj
MSBuildProjectFile	Reserviert	Der vollständige Dateiname der Projektdatei, einschließlich der Erweiterung, z.B. MyApp.proj.	ConsoleApp1.csproj
MSBuildProjectFullPath	Reserviert	Der absolute Pfad und der vollständige Dateiname der Projektdatei, einschließlich der Erweiterung, beispielsweise C:\MyCompany\MyProduct\MyApp.proj.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildProjectName	Reserviert	Der Dateiname der Projektdatei ohne die Erweiterung, z.B. MyApp.	ConsoleApp1
MSBuildRuntimeType	Reserviert	Der Typ der Laufzeit, der derzeit ausgeführt wird. Eingeführt in MSBuild 15. Der Wert ist möglicherweise nicht definiert (vor MSBuild 15). Full gibt an, dass MSBuild auf dem Desktop .NET Framework ausgeführt wird, Core, dass MSBuild unter .NET Core ausgeführt wird (z. B. in dotnet build) und Mono, dass MSBuild unter Mono ausgeführt wird.	Full
MSBuildStartupDirectory	Reserviert	Der absolute Pfad des Ordners, in dem MSBuild aufgerufen wird. Wenn Sie diese Eigenschaft verwenden, können Sie alles unterhalb eines bestimmten Punkts in einer Projektstruktur erstellen, ohne <dirs>.proj-Dateien in jedem Verzeichnis zu erstellen. Stattdessen haben Sie wie hier gezeigt nur ein Projekt, beispielsweise C:\traversal.proj: <Project ...> <ItemGroup> <ProjectFiles Include="$ (MSBuildStartupDirectory) **\*.csproj"/> </ItemGroup> <Target Name="build"> <MSBuild Projects="@(ProjectFiles)"/> </Target> </Project> Geben Sie für die Erstellung an einem beliebigen Punkt in der Struktur Folgendes ein: msbuild c:\traversal.proj Schließen Sie nicht den abschließenden umgekehrten Schrägstrich in dieser Eigenschaft ein.	c:\Source\Repos\ConsoleApp1
MSBuildThisFile	Reserviert	Der Teil von MSBuildThisFileFullPath, der den Dateinamen und die Dateierweiterung angibt.	ConsoleApp1.csproj
MSBuildThisFileDirectory	Reserviert	Der Teil von MSBuildThisFileFullPath, der das Verzeichnis angibt. Schließen Sie den abschließenden umgekehrten Schrägstrich in den Pfad ein.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileDirectoryNoRoot	Reserviert	Der Teil von MSBuildThisFileFullPath, der das Verzeichnis angibt, ausschließlich des Stammlaufwerks. Schließen Sie den abschließenden umgekehrten Schrägstrich in den Pfad ein.	Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileExtension	Reserviert	Der Teil von MSBuildThisFileFullPath, der die Dateinamenerweiterung angibt.	.csproj
MSBuildThisFileFullPath	Reserviert	Der absolute Pfad des Projekts oder der TARGETS-Datei, die das gerade ausgeführte Ziel enthält. Tipp: Sie können einen relativen Pfad in einer TARGETS-Datei angegeben, der relativ zur TARGETS-Datei und nicht relativ zur ursprünglichen Projektdatei ist.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildThisFileName	Reserviert	Der Teil von MSBuildThisFileFullPath, der den Dateinamen angibt, jedoch ohne die Dateinamenerweiterung.	ConsoleApp1
MSBuildToolsPath	Reserviert	Der Installationspfad der MSBuild-Version, die mit dem Wert von MSBuildToolsVersion verknüpft ist. Schließen Sie den abschließenden umgekehrten Schrägstrich nicht in den Pfad ein. Diese Eigenschaft kann nicht überschrieben werden.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsPath32	Bekannt	Der Installationspfad der 32-Bit-MSBuild-Version, die mit dem Wert von MSBuildToolsVersion verknüpft ist. Schließen Sie den abschließenden umgekehrten Schrägstrich nicht in den Pfad ein. Diese Eigenschaft kann nicht überschrieben werden.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin
MSBuildToolsPath64	Bekannt	Der Installationspfad der 64-Bit-MSBuild-Version, die mit dem Wert von MSBuildToolsVersion verknüpft ist. Schließen Sie den abschließenden umgekehrten Schrägstrich nicht in den Pfad ein. Diese Eigenschaft kann nicht überschrieben werden.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsVersion	Reserviert	Die Version des MSBuild-Toolsets, das zum Erstellen des Projekts verwendet wird. Hinweis: Ein MSBuild-Toolset besteht aus Aufgaben, Zielen und Tools, die zum Erstellen einer Anwendung verwendet werden. Zu den Tools zählen Compiler wie csc.exe und vbc.exe. Weitere Informationen finden Sie unter MSBuild-Toolset (ToolsVersion) sowie unter Standardmäßige und benutzerdefinierte Toolsetkonfigurationen.	Current
MSBuildSDKsPath	Bekannt	Der Pfad, den MSBuild für die Suche nach SDKs verwendet.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Sdks
MSBuildSemanticVersion	Reserviert	Die vollständige, SemVer 2.0-Version der MSBuild-Assemblys, die zum Erstellen des Projekts verwendet wird.	17.4.0-preview-22465-05+6033e4c95
MSBuildUserExtensionsPath	Bekannt	Dieser Pfad gibt den Speicherort für den MSBuild-Installationsordner an. Er kann zurückgesetzt werden, um lokale benutzerspezifische Anpassungen bereitzustellen. Weitere Informationen finden Sie unter Anpassen des lokalen Builds. Schließen Sie den abschließenden umgekehrten Schrägstrich nicht in den Pfad ein.
MSBuildVersion	Reserviert	Die Version von MSBuild, die zum Erstellen des Projekts verwendet wird. Diese Eigenschaft kann nicht überschrieben werden. Andernfalls wird die Fehlermeldung MSB4004 - The 'MSBuildVersion' property is reserved, and can't be modified. zurückgegeben.	17.4.0
MSBuildWarningsAsErrors	Bekannt	Eine Liste von Warnungscodes, die als Fehler behandelt werden sollen.	MSB1234;MSB5678
MSBuildWarningsAsMessages	Bekannt	Eine Liste von Warnungscodes, die als Meldungen behandelt werden sollen.	MSB1234;MSB5678
MSBuildWarningsNotAsErrors	Bekannt	Eine Liste von Warnungscodes, die nicht auf Fehler heraufgestuft werden sollen, auch wenn der Schalter -warnAsError so festgelegt ist, dass alle anderen Warnungen auf Fehler heraufgestuft werden. Beachten Sie, dass dies keine Auswirkungen hat, wenn dieser Wert nicht TRUE ist.	MSB1234;MSB5678
OS	Bekannt	Unter Windows wird dies vom Hostbetriebssystem geerbt. Mögliche Werte sind „Windows_NT“ und „Unix“. Kann unter anderen Betriebssystemen als Windows auf andere Werte festgelegt werden.
RoslynTargetsPath	Bekannt	Der Pfad zu den Zielen für Roslyn-Compiler.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\Roslyn
SDK35ToolsPath	Bekannt	Der Pfad zu den .NET Framework 3.5-Tools.
SDK40ToolsPath	Bekannt	Der Pfad zu den .NET Framework 4.0-Tools.	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\
VsInstallRoot	Bekannt	Der Visual Studio-Installationsordner.	C:\Program Files\Microsoft Visual Studio\2022
WindowsSDK80Path	Bekannt	Der Pfad zum Windows 8 SDK.

Eigenschaften, die für C++-Projekte spezifisch sind.

Die folgenden Eigenschaften repräsentieren den Pfad zu den C++ MSBuild-Importdateien (z. B. .props- und .targets- Dateien), für verschiedene C++ Toolsetversionen und Zielbetriebssysteme. Die Dateien in diesen Ordnern repräsentieren die C++-Buildinfrastruktur und sind für die Erstellung jedes C++-Projekts mit MSBuild unerlässlich.

Eigenschaft	Reserviert oder bekannt	Beschreibung	Beispiel
AndroidTargetsPath	Bekannt	Der Pfad zu C++ MSBuild-Importdateien für Android-Builds.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\MDD\Android\V150\
iOSTargetsPath	Bekannt	Der Pfad zu C++ MSBuild-Importdateien für iOS-Builds.	C:\Program Files\Microsoft Visual Studio\2022\Preview\MSBuild\Microsoft\MDD\iOS\V150\
VCTargetsPath	Bekannt	Der Pfad zu C++ MSBuild-Dateien, die das C++-Buildsystem unterstützen.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\VC\v170\
VCTargetsPath10	Bekannt	Der Pfad zu C++ MSBuild-Dateien, die das Visual Studio 2010-Toolset unterstützen.	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\
VCTargetsPath11	Bekannt	Der Pfad zu den MSBuild-Importdateien für das Visual Studio 2012-Toolset (V110).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\
VCTargetsPath12	Bekannt	Der Pfad zu den MSBuild-Importdateien für das Visual Studio 2013-Toolset (V120).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\
VCTargetsPath14	Bekannt	Der Pfad zu den MSBuild-Importdateien für das Visual Studio 2015-Toolset (V140).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\

Namen, die Konflikte mit MSBuild-Elementen auslösen

Zusätzlich zu den oben genannten können MSBuild-Sprachelemente entsprechende Namen nicht für benutzerdefinierte Eigenschaften, Elemente oder Elementmetadaten verwendet werden:

• VisualStudioProject
• Target
• PropertyGroup
• Output
• ItemGroup
• UsingTask
• ProjectExtensions
• OnError
• ImportGroup
• Choose
• When
• Otherwise

Siehe auch

• MSBuild-Referenz

• MSBuild-Eigenschaften