Vyhrazené a známé vlastnosti nástroje MSBuild

NÁSTROJ MSBuild poskytuje sadu předdefinovaných vlastností, které ukládají informace o souboru projektu a binární soubory MSBuild. Tyto vlastnosti se vyhodnocují stejným způsobem jako ostatní vlastnosti nástroje MSBuild. Chcete-li například použít MSBuildProjectFile vlastnost, zadejte $(MSBuildProjectFile).

Nástroj MSBuild používá hodnoty v následující tabulce k předdefinovaným rezervovaným a dobře známým vlastnostem. Rezervované vlastnosti nelze přepsat a většina známých vlastností by neměla být přepsána s výjimkou pokročilých scénářů.

Rezervované a dobře známé vlastnosti

Tabulka v této části zobrazuje předdefinované vlastnosti nástroje MSBuild. Ukázkový sloupec v tabulce se vztahuje k následujícímu ukázkovém souboru projektu, předpokládá se, že je umístěn na C:\Source\Repos\ConsoleApp1\ConsoleApp1adrese a ukazuje příklad hodnot, které tyto vlastnosti mají při přístupu k souboru projektu, při vyvolání NÁSTROJE MSBuild bez speciálních možností příkazového řádku.

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

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

Vlastnost	Rezervované nebo dobře známé	Popis	Příklad
FrameworkSDKRoot	Well-known	Cesta ke kořenové složce pro nástroje rozhraní .NET Framework	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\
InnerBuildProperty	Well-known	Určuje název vlastnosti, která definuje dimenzi sestavení s více cílením (platí pouze v případě, že aktuální sestavení je sestavení grafu).	Targetframework
InnerBuildPropertyValues	Well-known	Určuje název vlastnosti, která obsahuje možné hodnoty pro danou InnerBuildProperty vlastnost (platí pouze v případě, že aktuální sestavení je sestavení grafu).	TargetFrameworks
IsGraphBuild	Well-known	True pokud se jedná o sestavení grafu, to znamená, -graphBuild že se tato možnost projeví. Tato možnost znamená, že NÁSTROJ MSBuild sestaví a sestaví graf projektu. Vytvoření grafu zahrnuje identifikaci odkazů projektu na závislosti formuláře. Sestavení grafu zahrnuje pokus o sestavení odkazů projektu před projekty, které na ně odkazují, a liší se od tradičního plánování nástroje MSBuild.
MSBuildAssemblyVersion	Rezervováno	Verze sestavení NÁSTROJE MSBuild použitá k sestavení projektu.	17.0
MSBuildBinPath	Rezervováno	Absolutní cesta ke složce, kde se nacházejí binární soubory MSBuild, které se právě používají (například C:\Windows\Microsoft.Net\Framework\<versionNumber>). Tato vlastnost je užitečná, pokud musíte odkazovat na soubory v adresáři MSBuild. Nezahrnujte do této vlastnosti konečné zpětné lomítko.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildDisableFeaturesFromVersion	Rezervováno	Nástroje MSBuild a sady MICROSOFT SDK slouží ke správě vln změn.
MSBuildExtensionsPath	Well-known	Představeno v rozhraní .NET Framework 4: mezi výchozími hodnotami MSBuildExtensionsPath a MSBuildExtensionsPath32. Proměnnou MSBUILDLEGACYEXTENSIONSPATH prostředí můžete nastavit na hodnotu, která není null, aby se povolilo chování výchozí hodnoty MSBuildExtensionsPath v dřívějších verzích. V rozhraní .NET Framework 3.5 a starších verzích MSBuildExtensionsPath výchozí hodnota odkazuje na cestu podsložky MSBuild ve složce \Program Files\ nebo \Program Files (x86) v závislosti na bitové verzi aktuálního procesu. Například pro 32bitový proces na 64bitovém počítači tato vlastnost odkazuje na složku \Program Files (x86). U 64bitového procesu na 64bitovém počítači tato vlastnost odkazuje na složku \Program Files . Nezahrnujte do této vlastnosti konečné zpětné lomítko. Toto umístění je užitečné místo pro umístění vlastních cílových souborů. Cílové soubory je například možné nainstalovat do složky \Program Files\MSBuild\MyFiles\Northwind.targets a pak je importovat do souborů projektu pomocí tohoto kódu XML: <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath32	Well-known	Cesta podsložky MSBuild ve složce \Program Files nebo \Program Files (x86). Cesta vždy odkazuje na 32bitovou složku \Program Files (x86) na 32bitovém počítači a \Program Files na 64bitovém počítači.". Viz také MSBuildExtensionsPath a MSBuildExtensionsPath64. Nezahrnujte do této vlastnosti konečné zpětné lomítko.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath64	Well-known	Cesta podsložky MSBuild ve složce \Program Files . U 64bitového počítače tato cesta vždy odkazuje na složku \Program Files . Pro 32bitový počítač je tato cesta prázdná. Viz také MSBuildExtensionsPath a MSBuildExtensionsPath32. Nezahrnujte do této vlastnosti konečné zpětné lomítko.	C:\Program Files\MSBuild
MSBuildFileVersion	Rezervováno	Verze 4 části sestavení NÁSTROJE MSBuild použitá k sestavení projektu.	17.4.0.46505
MSBuildFrameworkToolsPath	Well-known	Cesta k nástrojům rozhraní .NET Framework, se kterými se právě spouští nástroj MSBuild, byl vytvořen pomocí koncového lomítka.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath32	Well-known	Cesta k 32bitové verzi nástrojů rozhraní .NET Framework pro stejnou verzi rozhraní, se kterou byl aktuálně spuštěný nástroj MSBuild sestaven, s koncovým lomítkem.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath64	Well-known	Cesta k 64bitové verzi nástrojů rozhraní .NET Framework pro stejnou verzi rozhraní, se kterou byla vytvořena aktuálně spuštěná aplikace MSBuild, s koncové lomítko.	C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\
MSBuildInteractive	Rezervováno	true Pokud je nástroj MSBuild spuštěn interaktivně, povolte vstup uživatele. Toto nastavení řídí možnost příkazového -interactive řádku.	false
MSBuildLastTaskResult	Rezervováno	true pokud předchozí úkol byl dokončen bez chyb (i v případě upozornění) nebo false pokud předchozí úkol obsahoval chyby. Obvykle, když dojde k chybě v úkolu, je chyba poslední věcí, která se v daném projektu stane. Proto hodnota této vlastnosti není nikdy false, s výjimkou těchto scénářů: - Je-li atribut Task element (MSBuild) nastaven na WarnAndContinue (nebo ) nebo trueErrorAndContinue.ContinueOnError - Pokud Target má OnError element (MSBuild) jako podřízený prvek.	true
MSBuildNodeCount	Rezervováno	Maximální počet souběžných procesů, které se používají při sestavování. Jedná se o hodnotu, kterou jste zadali pro parametr -maxcpucount na příkazovém řádku. Pokud jste zadali parametr -maxcpucount bez zadání hodnoty, určuje MSBuildNodeCount počet procesorů v počítači. Další informace naleznete v tématu Reference příkazového řádku a Sestavení více projektů paralelně.	0
MSBuildOverrideTasksPath	Well-known	Umístění pro .overridetasks vyhledávání souborů, které lze použít k poskytování vlastních verzí standardních úloh. Viz úlohy NÁSTROJE MSBuild. Do cesty nezahrnujte konečné zpětné lomítko.
MSBuildProgramFiles32	Rezervováno	Umístění 32bitové složky programu; Například C:\Program Files (x86). Nezahrnujte do této vlastnosti konečné zpětné lomítko.	C:\Program Files (x86)
MSBuildProjectDefaultTargets	Rezervováno	Úplný seznam cílů zadaných v DefaultTargets atributu Project prvku. Například následující Project prvek by měl MSBuildDefaultTargets hodnotu A;B;Cvlastnosti : <Project DefaultTargets="A;B;C" >	Build
MSBuildProjectDirectory	Rezervováno	Absolutní cesta k adresáři, kde se nachází soubor projektu, například C:\MyCompany\MyProduct. Nezahrnujte do této vlastnosti konečné zpětné lomítko.	C:\Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectDirectoryNoRoot	Rezervováno	Hodnota MSBuildProjectDirectory vlastnosti s výjimkou kořenové jednotky. Nezahrnujte do této vlastnosti konečné zpětné lomítko.	Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectExtension	Rezervováno	Přípona názvu souboru projektu, včetně období; například .proj.	.csproj
MSBuildProjectFile	Rezervováno	Úplný název souboru projektu, včetně přípony názvu souboru; Například MyApp.proj.	ConsoleApp1.csproj
MSBuildProjectFullPath	Rezervováno	Absolutní cesta a úplný název souboru projektu, včetně přípony názvu souboru; Například C:\MyCompany\MyProduct\MyApp.proj.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildProjectName	Rezervováno	Název souboru projektu bez přípony názvu souboru; Například Moje aplikace.	ConsoleApp1
MSBuildRuntimeType	Rezervováno	Typ modulu runtime, který se právě spouští. Představeno v NÁSTROJi MSBuild 15. Hodnota může být nedefinovaná (před MSBuild 15), Full což znamená, že nástroj MSBuild běží na desktopovém rozhraní .NET Framework, což znamená, Core že nástroj MSBuild běží v .NET Core (například v dotnet build) nebo Mono indikuje, že nástroj MSBuild běží na mono.	Full
MSBuildStartupDirectory	Rezervováno	Absolutní cesta ke složce, ve které se volá NÁSTROJ MSBuild. Pomocí této vlastnosti můžete vytvořit vše pod konkrétním bodem ve stromu projektu bez vytváření <souborů dirs.proj> v každém adresáři. Místo toho máte jenom jeden projekt – například c:\traversal.proj, jak je znázorněno tady: <Project ...> <ItemGroup> <ProjectFiles Include="$ (MSBuildStartupDirectory) **\*.csproj"/> </ItemGroup> <Target Name="build"> <MSBuild Projects="@(ProjectFiles)"/> </Target> </Project> Pokud chcete vytvořit v libovolném bodě stromu, zadejte: msbuild c:\traversal.proj Nezahrnujte do této vlastnosti konečné zpětné lomítko.	c:\Source\Repos\ConsoleApp1
MSBuildThisFile	Rezervováno	Název souboru a část přípony souboru .MSBuildThisFileFullPath	ConsoleApp1.csproj
MSBuildThisFileDirectory	Rezervováno	Adresářová část souboru MSBuildThisFileFullPath. Do cesty zahrňte konečné zpětné lomítko.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileDirectoryNoRoot	Rezervováno	Část adresáře MSBuildThisFileFullPaths výjimkou kořenové jednotky. Do cesty zahrňte konečné zpětné lomítko.	Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileExtension	Rezervováno	Část přípony názvu souboru .MSBuildThisFileFullPath	.csproj
MSBuildThisFileFullPath	Rezervováno	Absolutní cesta k souboru projektu nebo cíle, který obsahuje cíl, který je spuštěný. Tip: Relativní cestu můžete zadat v souboru cíle, který je relativní vzhledem k souboru cílů, a ne vzhledem k původnímu souboru projektu.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildThisFileName	Rezervováno	Část názvu souboru bez přípony MSBuildThisFileFullPathnázvu souboru.	ConsoleApp1
MSBuildToolsPath	Rezervováno	Instalační cesta verze NÁSTROJE MSBuild, která je přidružena k hodnotě MSBuildToolsVersion. Do cesty nezahrnujte konečné zpětné lomítko. Tuto vlastnost nelze přepsat.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsPath32	Well-known	Instalační cesta 32bitové verze NÁSTROJE MSBuild, která je přidružena k hodnotě MSBuildToolsVersion. Do cesty nezahrnujte konečné zpětné lomítko. Tuto vlastnost nelze přepsat.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin
MSBuildToolsPath64	Well-known	Instalační cesta 64bitové verze NÁSTROJE MSBuild, která je přidružena k hodnotě MSBuildToolsVersion. Do cesty nezahrnujte konečné zpětné lomítko. Tuto vlastnost nelze přepsat.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsVersion	Rezervováno	Verze sady nástrojů MSBuild, která se používá k sestavení projektu. Poznámka: Sada nástrojů MSBuild se skládá z úloh, cílů a nástrojů, které se používají k sestavení aplikace. Mezi tyto nástroje patří kompilátory, jako jsou csc.exe a vbc.exe. Další informace naleznete v tématu Sada nástrojů (ToolsVersion) a Standardní a vlastní konfigurace sady nástrojů.	Current
MSBuildSDKsPath	Well-known	Cesta MSBuild používá k vyhledání sad SDK.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Sdks
MSBuildSemanticVersion	Rezervováno	Úplná verze semver 2.0 sestavení MSBuild použitá k sestavení projektu.	17.4.0-preview-22465-05+6033e4c95
MSBuildUserExtensionsPath	Well-known	Tato cesta poskytuje umístění instalační složky nástroje MSBuild. Dá se resetovat tak, aby poskytoval místní vlastní nastavení pro jednotlivé uživatele. Viz Přizpůsobení místního sestavení. Do cesty nezahrnujte konečné zpětné lomítko.
MSBuildVersion	Rezervováno	Verze nástroje MSBuild použitá k sestavení projektu. Tuto vlastnost nelze přepsat, jinak se vrátí chybová zpráva MSB4004 - The 'MSBuildVersion' property is reserved, and can't be modified. .	17.4.0
MSBuildWarningsAsErrors	Well-known	Seznam kódů upozornění, které se mají považovat za chyby.	MSB1234;MSB5678
MSBuildWarningsAsMessages	Well-known	Seznam kódů upozornění, které se mají považovat za zprávy.	MSB1234;MSB5678
MSBuildWarningsNotAsErrors	Well-known	Seznam kódů upozornění, které by neměly být povýšeny na chyby, i když -warnAsError je přepínač nastaven tak, aby propagoval všechna ostatní upozornění na chyby. Mějte na paměti, že pokud to není pravda, nemá žádný vliv.	MSB1234;MSB5678
OS	Well-known	Ve Windows se dědí z hostitelského operačního systému. Možné hodnoty zahrnují "Windows_NT" a "Unix"; lze nastavit na jiné hodnoty v jiných operačních systémech než Windows.
RoslynTargetsPath	Well-known	Cesta k cílům pro kompilátory Roslyn	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\Roslyn
SDK35ToolsPath	Well-known	Cesta k nástrojům rozhraní .NET Framework 3.5
SDK40ToolsPath	Well-known	Cesta k nástrojům rozhraní .NET Framework 4.0	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\
VsInstallRoot	Well-known	Instalační složka sady Visual Studio.	C:\Program Files\Microsoft Visual Studio\2022
WindowsSDK80Path	Well-known	Cesta k sadě Windows 8 SDK

Vlastnosti specifické pro projekty C++

Následující vlastnosti představují cestu k importu souborů C++ MSBuild, jako .props jsou a .targets soubory, pro různé verze sady nástrojů C++ a cílové operační systémy. Soubory v těchto složkách představují infrastrukturu sestavení jazyka C++ a jsou nezbytné pro sestavení libovolného projektu C++ pomocí nástroje MSBuild.

Vlastnost	Rezervované nebo dobře známé	Popis	Příklad
AndroidTargetsPath	Well-known	Cesta k souborům importu nástroje MSBuild jazyka C++ pro buildy Androidu	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\MDD\Android\V150\
iOSTargetsPath	Well-known	Cesta k souborům importu nástroje MSBuild v jazyce C++ pro sestavení iOS	C:\Program Files\Microsoft Visual Studio\2022\Preview\MSBuild\Microsoft\MDD\iOS\V150\
VCTargetsPath	Well-known	Cesta k souborům C++ MSBuild, které podporují systém sestavení C++.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\VC\v170\
VCTargetsPath10	Well-known	Cesta k souborům C++ MSBuild, které podporují sadu nástrojů sady Visual Studio 2010	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\
VCTargetsPath11	Well-known	Cesta k souborům importu nástroje MSBuild pro sadu nástrojů sady Visual Studio 2012 (V110).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\
VCTargetsPath12	Well-known	Cesta k souborům importu nástroje MSBuild pro sadu nástrojů sady Visual Studio 2013 (V120).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\
VCTargetsPath14	Well-known	Cesta k souborům importu nástroje MSBuild pro sadu nástrojů sady Visual Studio 2015 (V140).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\

Názvy, které jsou v konfliktu s elementy MSBuild

Kromě výše uvedených názvů nelze názvy odpovídající elementům jazyka MSBuild použít pro uživatelsky definované vlastnosti, položky nebo metadata položek:

• VisualStudioProject
• Cíl
• Propertygroup
• Výstup
• ItemGroup
• UsingTask
• ProjectExtensions
• Přichybě
• ImportGroup
• Zvolit
• Když
• Jinak

Viz také

• Referenční dokumentace nástroje MSBuild

• Vlastnosti nástroje MSBuild