Sdílet prostřednictvím

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

  • Článek

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

MSBuild používá předdefinovat vlastnosti vyhrazené a dobře známé hodnoty v následující tabulce.Rezervované vlastnosti nemůže být přepsáno, ale dobře známé vlastnosti lze přepsat pomocí vlastnosti stejně pojmenované prostředí, globální vlastnosti nebo vlastnosti, které jsou deklarovány v souboru projektu.

Vyhrazené a známé vlastnosti

V následující tabulce jsou uvedeny MSBuild předdefinované vlastnosti.

Vlastnost

Popis

Rezervované nebo dobře známé

MSBuildBinPath

Absolutní cesta ke složce kde MSBuild binární soubory, které jsou právě používány jsou umístěny (například C:\Windows\Microsoft.Net\Framework\číslo verze).Tato vlastnost je užitečná, pokud je třeba odkazují na soubory v MSBuild adresář.

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Vyhrazena

MSBuildExtensionsPath

Zavedena v rozhraní .NET Framework 4: není žádný rozdíl mezi hodnotami výchozí MSBuildExtensionsPath a MSBuildExtensionsPath32.Můžete nastavit proměnnou prostředí MSBUILDLEGACYEXTENSIONSPATH na nenulovou hodnotu, chcete-li povolit chování výchozí hodnotu MSBuildExtensionsPath ve starších verzích.

V rozhraní .NET Framework 3.5 a starší, výchozí hodnotu MSBuildExtensionsPath odkazuje na cestu MSBuild podsložku \Program Files\ nebo \Program Files (x 86) složky, v závislosti na počtu bitů aktuální proces.32bitový proces na 64bitového počítače, například tato vlastnost odkazuje na složku \Program Files (x 86).Proces 64bitové na 64bitového počítače tato vlastnost odkazuje na složku \Program soubory.

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Toto umístění je vhodné místo pro umístění vlastní cílové soubory.Cílové soubory například může instalovat na \Program Files\MSBuild\MyFiles\Northwind.targets a importu v souborech projektu s použitím tohoto kódu XML:

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

Dobře známé

MSBuildExtensionsPath32

Cesta MSBuild podsložku \Program soubory nebo složky \Program Files (x 86).Tato cesta vždy odkazuje na složku \Program 32bitový soubory na 32bitového počítače a \Program Files (x 86) na 64bitového počítače.Viz také MSBuildExtensionsPath a MSBuildExtensionsPath64.

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Dobře známé

MSBuildExtensionsPath64

Cesta MSBuild podsložky ve složce \Program Files.Pro 64bitového počítače tato cesta vždy odkazuje na složku \Program soubory.U 32bitového počítače tato cesta je prázdná.Viz také MSBuildExtensionsPath a MSBuildExtensionsPath32.

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Dobře známé

MSBuildLastTaskResult

truePokud předchozí úkol dokončen bez chyb (i v případě, že došlo k upozornění), nebo false Pokud předchozí úlohy došlo k chybám.Dojde-li k chybě v rámci úlohy, je chyba obvykle poslední věcí, která se stane v tomto projektu.Hodnota této vlastnosti tedy nikdy false, není-li v těchto případech:

Vyhrazena

MSBuildNodeCount

Maximální počet souběžných procesů, které se používají při vytváření.Jedná se o hodnotu, kterou jste zadali pro /maxcpucount na 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.

Vyhrazena

MSBuildProgramFiles32

Umístění složky program 32-bit; Můžete například C:\Program Files (x86).

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Vyhrazena

MSBuildProjectDefaultTargets

Úplný seznam cílů, které jsou určeny v DefaultTargets atributu Project elementu.Například následující Project by element obsahovat MSBuildDefaultTargets hodnotě vlastnosti A;B;C:

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

Vyhrazena

MSBuildProjectDirectory

Absolutní cesta k adresáři, kde projektový soubor nachází, například C:\MyCompany\MyProduct.

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Vyhrazena

MSBuildProjectDirectoryNoRoot

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

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Vyhrazena

MSBuildProjectExtension

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

Vyhrazena

MSBuildProjectFile

Název souboru dokončení souboru projektu, včetně přípony názvu souboru; Můžete například MyApp.proj.

Vyhrazena

MSBuildProjectFullPath

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

Vyhrazena

MSBuildProjectName

Název souboru projektový soubor bez přípony názvu souboru; Můžete například Moje aplikace.

Vyhrazena

MSBuildStartupDirectory

Absolutní cesta složky, kde MSBuild je volána.Pomocí této vlastnosti můžete vytvořit vše pod určitého bodu v strom projektu bez vytvoření souborů dirs.proj v každém adresáři.Namísto toho obsahovat 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>

Chcete-li vytvořit kdykoli ve stromu, zadejte:

msbuild c:\traversal.proj

Nezahrnujte finální zpětné lomítko pro tuto vlastnost.

Vyhrazena

MSBuildThisFile

Název souboru a část souboru rozšíření MSBuildThisFileFullPath.

Vyhrazena

MSBuildThisFileDirectory

Část adresář MSBuildThisFileFullPath.

Zahrňte do cesty finální zpětné lomítko.

Vyhrazena

MSBuildThisFileDirectoryNoRoot

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

Zahrňte do cesty finální zpětné lomítko.

Vyhrazena

MSBuildThisFileExtension

Název souboru rozšíření část MSBuildThisFileFullPath.

Vyhrazena

MSBuildThisFileFullPath

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

Tip

Zadání relativní cesty v souboru cíle, který je relativní k souboru cílů a není vzhledem k původní soubor projektu.

Vyhrazena

MSBuildThisFileName

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

Vyhrazena

MSBuildToolsPath

Instalační cesta MSBuild verze, která je přiřazena k hodnotě MSBuildToolsVersion.

Nezahrnujte finální lomítkem v cestě.

Tato vlastnost nemůže být přepsána.

Vyhrazena

MSBuildToolsVersion

Verze MSBuild sadu nástrojů, který slouží k sestavení projektu.

[!POZNÁMKA]

MSBuild Sadu nástrojů se skládá z úlohy, cílů a nástroje, které se používají k vytváření aplikací.Tyto nástroje zahrnují například csc.exe a vbc.exe kompilátoru.Další informace naleznete v tématech Sada nástrojů MSBuild (atribut ToolsVersion) a Standardní a vlastní konfigurace sady nástrojů.

Vyhrazena

Viz také

Koncepty

Vlastnosti nástroje MSBuild

Další zdroje

Referenční dokumentace nástroje MSBuild