Project – element (MSBuild)

  • Článek

Povinný kořenový prvek souboru projektu MSBuild.

Syntaxe

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         TreatAsLocalProperty="PropertyA;PropertyB"
         ToolsVersion="<version number>"
         Sdk="name[/version]"
         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Sdk... />
    <Choose>... </Choose>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Target>... </Target>
    <UsingTask.../>
    <ProjectExtensions>... </ProjectExtensions>
    <Import... />
</Project>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut Popis
DefaultTargets Nepovinný atribut.

Výchozí cíl nebo cíle, které mají být vstupním bodem sestavení, pokud nebyl zadán žádný cíl. Více cílů je středník (;) oddělených.

Pokud není v atributu DefaultTargets nebo příkazovém řádku MSBuild zadán žádný výchozí cíl, modul po vyhodnocení elementů Import spustí první cíl v souboru projektu.
InitialTargets Nepovinný atribut.

Počáteční cíl nebo cíle, které se mají spustit před cíli zadanými v atributu DefaultTargets nebo na příkazovém řádku. Více cílů je odděleno středníkem (;). Pokud definuje InitialTargetsvíce importovaných souborů, spustí se všechny uvedené cíle v pořadí, v jakém se importy najdou.
Sdk Nepovinný atribut.

Název sady SDK a volitelná verze pro vytvoření implicitních příkazů importu, které se přidají do souboru .proj. Pokud není zadaná žádná verze, nástroj MSBuild se pokusí přeložit výchozí verzi. Například <Project Sdk="Microsoft.NET.Sdk" /> nebo <Project Sdk="My.Custom.Sdk/1.0.0" />.
ToolsVersion Nepovinný atribut.

Verze sady nástrojů MSBuild používá k určení hodnot $(MSBuildBinPath) a $(MSBuildToolsPath).
TreatAsLocalProperty Nepovinný atribut.

Názvy vlastností, které nebudou považovány za globální. Tento atribut zabraňuje přepsání konkrétních vlastností příkazového řádku, které jsou nastaveny v projektu nebo cílovém souboru a všechny následné importy. Více vlastností je středník (;) oddělených.

Za normálních okolností globální vlastnosti přepisují hodnoty vlastností, které jsou nastaveny v souboru projektu nebo cíle. Pokud je vlastnost uvedena v hodnotě TreatAsLocalProperty , globální hodnota vlastnosti nepřepíše hodnoty vlastností, které jsou nastaveny v tomto souboru a všechny následné importy. Další informace naleznete v tématu Postupy: Sestavení stejných zdrojových souborů s různými možnostmi. Poznámka: Globální vlastnosti nastavíte na příkazovém řádku pomocí přepínače -property (nebo -p). Pomocí atributu úlohy MSBuild můžete také nastavit nebo upravit globální vlastnosti podřízených projektů v sestavení Properties s více projekty. Další informace naleznete v tématu MSBuild úloha.
xmlns Nepovinný atribut.

Při zadání xmlns musí mít atribut hodnotu http://schemas.microsoft.com/developer/msbuild/2003.

Podřízené prvky

Element (Prvek) Popis
Zvolit Volitelný element.

Vyhodnotí podřízené prvky a vybere jednu sadu ItemGroup prvků nebo PropertyGroup prvků, které se mají vyhodnotit.
Import Volitelný element.

Umožňuje souboru projektu importovat jiný soubor projektu. V projektu může být nula nebo více Import prvků.
ImportGroup Volitelný element.

Obsahuje kolekci Import prvků, které jsou seskupeny pod volitelnou podmínkou.
ItemGroup Volitelný element.

Prvek seskupení pro jednotlivé položky. Položky jsou určeny pomocí elementu Item . V projektu může být nula nebo více ItemGroup prvků.
ItemDefinitionGroup Volitelný element.

Umožňuje definovat sadu definic položek, což jsou hodnoty metadat, které se ve výchozím nastavení použijí pro všechny položky v projektu. ItemDefinitionGroup nahrazuje nutnost používat CreateItem úkol a CreateProperty úkol.
ProjectExtensions Volitelný element.

Poskytuje způsob, jak zachovat informace jiné než MSBuild v souboru projektu MSBuild. V projektu může být nula nebo jeden ProjectExtensions prvek.
Propertygroup Volitelný element.

Seskupovací prvek pro jednotlivé vlastnosti. Vlastnosti jsou určeny pomocí property elementu. V projektu může být nula nebo více PropertyGroup prvků.
Sdk Volitelný element.

Odkazuje na sadu SDK projektu MSBuild. Tento prvek lze použít jako alternativu k atributu sdk.
Cíl Volitelný element.

Obsahuje sadu úloh pro MSBuild, které se mají sekvenčně spouštět. Úkoly jsou určeny pomocí elementu Task . V projektu může být nula nebo více Target prvků.
UsingTask Volitelný element.

Poskytuje způsob registrace úloh v nástroji MSBuild. V projektu může být nula nebo více UsingTask prvků.

Nadřazené prvky

Žádné

Viz také