Project-Element (MSBuild)

Erforderliches Stammelement einer MSBuild-Projektdatei.

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         ToolsVersion=<version number>
         xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Choose>... </Choose>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Target>... </Target>
    <UsingTask.../>
    <ProjectExtensions>... </ProjectExtensions>
    <Import... />
</Project>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

DefaultTargets

Optionales Attribut.

Ein oder mehrere Standardziele, die als Einstiegspunkt des Builds verwendet werden sollen, wenn kein Ziel angegeben wurde. Mehrere Ziele werden durch Semikolons (;) voneinander getrennt.

Wenn weder im DefaultTargets-Attribut noch in der MSBuild-Befehlszeile ein Standardziel angegeben wurde, führt das Modul nach der Auswertung der Import-Elemente das erste Ziel in der Projektdatei aus.

InitialTargets

Optionales Attribut.

Eines oder mehrere anfängliche Ziele, die vor den im DefaultTargets-Attribut oder in der Befehlszeile angegebenen Zielen ausgeführt werden sollen. Mehrere Ziele werden durch Semikolons (;) voneinander getrennt.

ToolsVersion

Optionales Attribut.

Die Version des Toolsets, das MSBuild verwendet, um die Werte für $(MSBuildBinPath) und $(MSBuildToolsPath) zu bestimmen.

Xmlns

Erforderliches Attribut.

Das xmlns-Attribut muss über den Wert "https://schemas.microsoft.com/developer/msbuild/2003" verfügen.

Untergeordnete Elemente

Element

Beschreibung

Choose

Optionales Element

Wertet untergeordnete Elemente aus, um auszuwertende ItemGroup-Elemente und/oder PropertyGroup-Elemente auszuwählen.

Importieren

Optionales Element.

Ermöglicht das Importieren einer Projektdatei in eine andere Projektdatei. Es kann keine oder mehrere Import-Elemente in einem Projekt geben.

ItemGroup

Optionales Element.

Ein Gruppierungselement für einzelne Elemente. Elemente werden mit dem Item-Element angegeben. Es kann keine oder mehrere ItemGroup-Elemente in einem Projekt geben.

ProjectExtensions

Optionales Element.

Bietet eine Möglichkeit, nicht MSBuild-spezifische Informationen innerhalb einer MSBuild-Projektdatei beizubehalten. Es kann kein oder ein ProjectExtensions-Element in einem Projekt geben.

PropertyGroup

Optionales Element.

Ein Gruppierungselement für einzelne Eigenschaften. Eigenschaften werden mit dem Property-Element angegeben. Es kann keine oder mehrere PropertyGroup-Elemente in einem Projekt geben.

Target

Optionales Element.

Enthält Aufgaben, die MSBuild sequenziell ausführen soll. Aufgaben werden mit dem Task-Element angegeben. Es kann keine oder mehrere Target-Elemente in einem Projekt geben.

UsingTask

Optionales Element.

Bietet eine Möglichkeit, Aufgaben in MSBuild zu registrieren. Es kann keine oder mehrere UsingTask-Elemente in einem Projekt geben.

Übergeordnete Elemente

Keine.

Siehe auch

Aufgaben

Gewusst wie: Angeben des zuerst zu erstellenden Ziels

Referenz

MSBuild-Befehlszeilenreferenz

Konzepte

Referenz zum MSBuild-Projektdateischema

Weitere Ressourcen

MSBuild Overview