Share via


Project-Element (MSBuild)

Erforderliches Stammelement einer MSBuild-Projektdatei.

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         TreatAsLocalProperty="PropertyA;PropertyB"
         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 sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut

Description

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.

TreatAsLocalProperty

Optionales Attribut.

Eigenschaftennamen, die nicht als global berücksichtigt werden. Dieses Attribut verhindert bestimmte Befehlszeileneigenschaften am Überschreiben der Eigenschaftswerte, die in einer Projekt- oder Zieldatei und in allen nachfolgenden Importen festgelegt werden. Mehrere Eigenschaften sind das Semikolon (;) getrennt.

Normalerweise globale Eigenschaften überschreiben Eigenschaftswerte, die im Projekt oder in der Zieldatei festgelegt werden. Wenn die - Eigenschaft im TreatAsLocalProperty-Wert aufgeführt ist, überschreibt der globale Eigenschaftswert nicht Eigenschaftswerte, die in dieser Datei und in allen nachfolgenden Importen festgelegt werden. Weitere Informationen finden Sie unter Gewusst wie: Erstellen identischer Quelldateien mit unterschiedlichen Optionen.

Hinweis

Sie legen globale Eigenschaften an einer Eingabeaufforderung mithilfe des Schalters /property (oder /p).Sie können auch festlegen, oder, globale Eigenschaften für untergeordnete Projekte in einem Build mit mehreren Projekten, indem Sie das - Attribut Properties MSBuild, Ändern von weisen Sie eine Arbeit zu.Weitere Informationen finden Sie unter MSBuild-Aufgabe.

Xmlns

Erforderliches Attribut.

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

Untergeordnete Elemente

Element

Description

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