Project-Element (MSBuild)Project element (MSBuild)

Erforderliches Stammelement einer MSBuild-Projektdatei.Required root element of an MSBuild project file.

SyntaxSyntax

<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>

Attribute und ElementeAttributes and elements

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.The following sections describe attributes, child elements, and parent elements.

AttributeAttributes

AttributAttribute BeschreibungDescription
DefaultTargets Optionales Attribut.Optional attribute.

Das Standardziel oder die Standardziele, die zum Einstiegspunkt des Builds werden, wenn kein Ziel angegeben wurde.The default target or targets to be the entry point of the build if no target has been specified. Mehrere Ziele werden durch Semikolons (;) getrennt.Multiple targets are semi-colon (;) delimited.

Wenn kein Standardziel im DefaultTargets-Attribut oder über die MSBuild-Befehlszeile angegeben wurde, führt die Engine das erste Ziel in der Projektdatei aus, nachdem die Import-Elemente ausgewertet wurden.If no default target is specified in either the DefaultTargets attribute or the MSBuild command line, the engine executes the first target in the project file after the Import elements have been evaluated.
InitialTargets Optionales Attribut.Optional attribute.

Die anfänglichen Ziele werden ausgeführt bevor die Ziele im DefaultTargets-Attribut oder in der Befehlszeile angegeben werden .The initial target or targets to be run before the targets specified in the DefaultTargets attribute or on the command line. Mehrere Ziele werden durch ein Semikolon (;) getrennt.Multiple targets are semi-colon (;) delimited. Wenn mehrere importierte Dateien InitialTargets definieren, werden alle aufgeführten Ziele in der Reihenfolge ausgeführt, in der die Importe ermittelt werden.If multiple imported files define InitialTargets, all targets mentioned will be run, in the order the imports are encountered.
Sdk Optionales Attribut.Optional attribute.

Der SDK-Name und optional die Version, mit denen implizite Importanweisungen, die der PROJ-Datei hinzugefügt werden, erstellt werden.The SDK name and optional version to use to create implicit Import statements that are added to the .proj file. Wenn keine Version angegeben wird, versucht MSBuild eine Standardversion aufzulösen.If no version is specified, MSBuild will attempt to resolve a default version. Beispielsweise <Project Sdk="Microsoft.NET.Sdk" /> oder <Project Sdk="My.Custom.Sdk/1.0.0" />.For example, <Project Sdk="Microsoft.NET.Sdk" /> or <Project Sdk="My.Custom.Sdk/1.0.0" />.
ToolsVersion Optionales Attribut.Optional attribute.

Die Version des Toolsets, das MSBuild verwendet, um die Werte für $(MSBuildBinPath) und (MSBuildToolsPath) zu bestimmen.The version of the Toolset MSBuild uses to determine the values for $(MSBuildBinPath) and $(MSBuildToolsPath).
TreatAsLocalProperty Optionales Attribut.Optional attribute.

Eigenschaftennamen, die nicht als global betrachtet werden.Property names that won't be considered to be global. Dieses Attribut verhindert, dass bestimmte Befehlszeileneigenschaften Eigenschaftswerte überschreiben, die in einer Projekt- oder Zieldatei und allen nachfolgenden Importen festgelegt sind.This attribute prevents specific command-line properties from overriding property values that are set in a project or targets file and all subsequent imports. Mehrere Eigenschaften werden durch Semikolons (;) getrennt.Multiple properties are semi-colon (;) delimited.

Diese globalen Eigenschaften überschreiben normalerweise Eigenschaftswerte, die in der Projektdatei oder in Zieldateien festgelegt werden.Normally, global properties override property values that are set in the project or targets file. Wenn die Eigenschaft im TreatAsLocalProperty-Wert aufgeführt wird, überschreibt der globale Eigenschaftenwert die Eigenschaftenwerte nicht, die in dieser Datei und allen nachfolgenden Importen festgelegt werden.If the property is listed in the TreatAsLocalProperty value, the global property value doesn't override property values that are set in that file and any subsequent imports. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen identischer Quelldateien mit unterschiedlichen Optionen.For more information, see How to: Build the same source files with different options. Hinweis: Sie legen globale Eigenschaften in der Befehlszeile mit dem Switch -property (oder -p) fest.Note: You set global properties at a command prompt by using the -property (or -p) switch. Globale Eigenschaften können auch für untergeordnete Projekte in einem Build mit mehreren Projekten festgelegt oder geändert werden, indem das Properties-Attribut der MSBuild-Aufgabe verwendet wird.You can also set or modify global properties for child projects in a multi-project build by using the Properties attribute of the MSBuild task. Weitere Informationen finden Sie unter MSBuild-Aufgabe.For more information, see MSBuild task.
xmlns Optionales Attribut.Optional attribute.

Wenn das xmlns-Attribut angegeben wird, muss als Wert http://schemas.microsoft.com/developer/msbuild/2003 festgelegt sein.When specified, the xmlns attribute must have the value of http://schemas.microsoft.com/developer/msbuild/2003.

Untergeordnete ElementeChild elements

ElementElement BeschreibungDescription
AuswählenChoose Optionales Element.Optional element.

Bewertet untergeordnete Elemente, um einen Satz von auszuwertenden ItemGroup-Elementen und/oder PropertyGroup-Elementen auszuwählen.Evaluates child elements to select one set of ItemGroup elements and/or PropertyGroup elements to evaluate.
ImportierenImport Optionales Element.Optional element.

Ermöglicht den Import einer Projektdatei in eine andere Projektdatei.Enables a project file to import another project file. Es kann kein oder mehrere Import-Elemente in einem Projekt geben.There may be zero or more Import elements in a project.
ImportGroupImportGroup Optionales Element.Optional element.

Enthält eine Sammlung von Import-Elementen, die unter einer optionalen Bedingung gruppiert sind.Contains a collection of Import elements that are grouped under an optional condition.
ItemGroupItemGroup Optionales Element.Optional element.

Ein Gruppierungselement für einzelne Elemente.A grouping element for individual items. Elemente werden mit dem Item-Element angegeben.Items are specified by using the Item element. Es kann kein oder mehrere ItemGroup-Elemente in einem Projekt geben.There may be zero or more ItemGroup elements in a project.
ItemDefinitionGroupItemDefinitionGroup Optionales Element.Optional element.

Mit diesem Element können Sie Elementdefinitionen festlegen, die Metadatenwerte sind, die standardmäßig auf alle Elemente im Projekt angewandt werden.Lets you define a set of Item Definitions, which are metadata values that are applied to all items in the project, by default. Mit ItemDefinitionGroup ist die Verwendung der CreateItem-Aufgabe und der CreateProperty-Aufgabe überflüssig.ItemDefinitionGroup supersedes the need to use the CreateItem task and the CreateProperty task.
ProjectExtensionsProjectExtensions Optionales Element.Optional element.

Bietet eine Möglichkeit, Nicht-MSBuild-Informationen in einer MSBuild-Projektdatei beizubehalten.Provides a way to persist non-MSBuild information in an MSBuild project file. Es kann kein oder mehrere ProjectExtensions-Elemente in einem Projekt geben.There may be zero or one ProjectExtensions elements in a project.
PropertyGroupPropertyGroup Optionales Element.Optional element.

Ein Gruppierungselement für einzelne Eigenschaften.A grouping element for individual properties. Eigenschaften werden mit dem Property-Element angegeben.Properties are specified by using the Property element. Es kann kein oder mehrere PropertyGroup-Elemente in einem Projekt geben.There may be zero or more PropertyGroup elements in a project.
SdkSdk Optionales Element.Optional element.

Verweist auf ein MSBuild-Projekt SDK.References an MSBuild project SDK. Dieses Element kann alternativ zum Sdk-Attribut verwendet werden.This element can be used as an alternative to the Sdk attribute.
TargetTarget Optionales Element.Optional element.

Enthält eine Reihe von Aufgaben, die MSBuild sequenziell ausführt.Contains a set of tasks for MSBuild to sequentially execute. Aufgaben werden mit dem Aufgaben-Element angegeben.Tasks are specified by using the Task element. Es kann kein oder mehrere Target-Elemente in einem Projekt geben.There may be zero or more Target elements in a project.
UsingTaskUsingTask Optionales Element.Optional element.

Bietet eine Möglichkeit, Aufgaben in MSBuild zu registrieren.Provides a way to register tasks in MSBuild. Es kann kein oder mehrere UsingTask-Elemente in einem Projekt geben.There may be zero or more UsingTask elements in a project.

Übergeordnete ElementeParent elements

KeineNone.

Siehe auchSee also