Sdílet prostřednictvím

Nástroj MSBuild vyhrazena vlastnosti

  • Článek

MSBuildposkytuje sadu rezervované vlastnosti, které ukládají informace o souboru projektu a MSBuild binárních souborů.Tyto vlastnosti jsou vyhodnocovány stejným způsobem jako ostatní MSBuild vlastnosti.Chcete-li použít například MSBuildProjectFile vlastnost, zadejte:

$(MSBuildProjectFile)

Rezervované vlastnosti

V následující tabulce jsou popsány MSBuild vyhrazena vlastnosti.

Property

Description

MSBuildBinPath

Absolutní cestu ke složce, kde MSBuild binární soubory, které jsou aktuálně používány se nacházejí (například C:\Windows\Microsoft.Net\Framework\číslo_verze\).Tato vlastnost je užitečná, máte-li odkazovat na soubory MSBuild adresáře.

MSBuildExtensionsPath

Cesta MSBuild podsložku \Program Files\ nebo \Program Files (x 86) \ složky, v závislosti na počtu bitů aktuálního okna.Například pro 32bitové okno v počítači 64-bit, cesta odkazuje na \Program Files (x 86) \ složky.Pro 64-bit okna v počítači 64-bit cesta odkazuje na složku \Program Files\.See also MSBuildExtensionsPath32 and MSBuildExtensionsPath64.

Toto umístění je vhodné místo, kam umístit vlastní cílové soubory.Například cílové soubory může nainstalován na \Program Files\MSBuild\MyFiles\Northwind.targets a poté importovány pomocí tohoto kódu XML v souborech projektu:

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

PoznámkaPoznámka
Můžete nastavit proměnnou prostředí MSBUILDLEGACYEXTENSIONSPATH na nenulovou hodnotu, chcete-li povolit chování MSBuildExtensionsPath v předchozích verzích.

MSBuildExtensionsPath32

Cesta MSBuild podsložku \Program Files\ nebo \Program Files (x 86) \ složky.Tato cesta se vždy odkazuje na složku \Program Files\ 32-bit na 32-bit počítače a \Program Files (x 86) \ na 64bitovém počítači.See also MSBuildExtensionsPath and MSBuildExtensionsPath64.

MSBuildExtensionsPath64

Cesta MSBuild v podsložce složky \Program Files\.Pro 64-bit stroje tuto cestu vždy odkazuje na složku \Program Files\.Pro 32bitové počítače tato cesta je prázdná.See also MSBuildExtensionsPath and MSBuildExtensionsPath32.

MSBuildLastTaskResult

truePokud předchozí úkol dokončen bez ohlášení chyby (i když došlo k upozorněním), nebo false je-li předchozí úlohy došlo k chybám.

PoznámkaPoznámka
Dojde-li k chybě v úkolu, chyba je obvykle poslední věc, která se stane v daném projektu.Hodnota této vlastnosti tedy nikdy false, s výjimkou v těchto scénářích:

MSBuildNodeCount

Maximální počet souběžných procesů, které se používají při vytváření.Jedná se o hodnotu, kterou jste určili pro /maxcpucount v příkazovém řádku.Pokud jste zadali /maxcpucount bez zadání hodnoty, pak MSBuildNodeCount určuje počet procesorů v počítači.Další informace naleznete v tématu Referenční dokumentace pro použití nástroje MSBuild v příkazovém řádku a Paralelní sestavování více projektů současně pomocí nástroje MSBuild.

MSBuildProgramFiles32

Umístění složky 32bitového programu; například C:\Program Files (x86).

MSBuildProjectDefaultTargets

Úplný seznam cílů, které jsou určeny v DefaultTargets atribut projektu prvku.Například následující Project by mít element MSBuildDefaultTargets hodnotu vlastnosti A;B;C:

<Project DefaultTargets="A;B;C" >

MSBuildProjectDirectory

Absolutní cestu k adresáři, kde je umístěn; soubor projektu například C:\MyCompany\MyProduct\.

MSBuildProjectDirectoryNoRoot

Hodnota MSBuildProjectDirectory vlastnost, s výjimkou kořenové jednotce.

MSBuildProjectExtension

Příponu názvu souboru projektu, včetně období; například .proj.

MSBuildProjectFile

Úplný název souboru projektu, včetně přípony názvu souboru; například MyApp.proj.

MSBuildProjectFullPath

Absolutní cesta a úplný název souboru projektu, včetně přípony názvu souboru; například C:\MyCompany\MyProduct\MyApp.proj.

MSBuildProjectName

Název souboru projektu souboru bez přípony názvu souboru; Příklad MyApp.

MSBuildStartupDirectory

Absolutní cestu ke složce, kde MSBuild je volána.Pomocí této vlastnosti můžete sestavit vše pod určitý bod ve stromu projektu bez vytváření souborů dirs.proj ve všech adresářích.Místo toho máte pouze jeden projekt – například c:\traversal.proj, jak je znázorněno zde:

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

Sestavit kdykoliv ve stromové struktuře, zadejte příkaz:

msbuild c:\traversal.proj

MSBuildThisFile

Název souboru a příponu souboru části MSBuildThisFileFullPath.

MSBuildThisFileDirectory

Část adresáře MSBuildThisFileFullPath.

MSBuildThisFileDirectoryNoRoot

Část adresáře MSBuildThisFileFullPath, s výjimkou kořenové jednotce.

MSBuildThisFileExtension

Název souboru příponu část MSBuildThisFileFullPath.

MSBuildThisFileFullPath

Absolutní cesta k souboru projektu nebo cíle, který obsahuje cíl, který je spuštěn.

TipTip
MSBuildThisFileFullPath Vlastnost povoluje specifikace relativní cesty v souboru cíle, který je relativní k souboru cíle a není vzhledem k původní soubor projektu.

MSBuildThisFileName

Část názvu souboru MSBuildThisFileFullPath, bez přípony názvu souboru.

MSBuildToolsPath

Cestu k instalaci MSBuild verze, který je spojen s hodnotou MSBuildToolsVersion.

MSBuildToolsVersion

Verze MSBuild sada nástrojů, které slouží k sestavení projektu.

PoznámkaPoznámka
MSBuild Sada nástrojů se skládá z úkoly, cíle a nástroje, které se používají k vytváření aplikací.Nástroje obsahují kompilátory například csc.exe a vbc.exe.Další informace naleznete v tématu Sada nástrojů MSBuild (atribut ToolsVersion) a Standardní a vlastní konfigurace sady nástrojů.

Viz také

Koncepty

Nástroj MSBuild vlastnosti

Další zdroje

Nástroj MSBuild odkaz