Elemento Project (MSBuild)Project element (MSBuild)

Elemento radice obbligatorio di un file di progetto MSBuildMSBuild .Required root element of an MSBuildMSBuild project file.

SintassiSyntax

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

Attributi ed elementiAttributes and elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescriptionDescription
DefaultTargets Attributo facoltativo.Optional attribute.

Destinazione o destinazioni predefinite che saranno il punto di ingresso della compilazione se non è stata specificata alcuna destinazione.The default target or targets to be the entry point of the build if no target has been specified. Per specificare più destinazioni, usare il punto e virgola (;) come delimitatore.Multiple targets are semi-colon (;) delimited.

Se non viene specificata alcuna destinazione predefinita nell'attributo DefaultTargets né nella riga di comando di MSBuildMSBuild il motore esegue la prima destinazione nel file di progetto dopo che gli elementi Import sono stati valutati.If no default target is specified in either the DefaultTargets attribute or the MSBuildMSBuild command line, the engine executes the first target in the project file after the Import elements have been evaluated.
InitialTargets Attributo facoltativo.Optional attribute.

Destinazione o destinazioni iniziali da eseguire prima delle destinazioni specificate nell'attributo DefaultTargets o nella riga di comando.The initial target or targets to be run before the targets specified in the DefaultTargets attribute or on the command line. Per specificare più destinazioni, usare il punto e virgola (;) come delimitatore.Multiple targets are semi-colon (;) delimited. Se più file importati definiscono InitialTargets, tutte le destinazioni menzionate verranno eseguite nell'ordine in cui si rilevano le importazioni.If multiple imported files define InitialTargets, all targets mentioned will be run, in the order the imports are encountered.
Sdk Attributo facoltativo.Optional attribute.

Nome e versione facoltativa dell'SDK da usare per creare istruzioni Import implicite che vengono aggiunte al file PROJ.The SDK name and optional version to use to create implicit Import statements that are added to the .proj file. Se non viene specificata alcuna versione, MSBuild tenterà di risolvere una versione predefinita.If no version is specified, MSBuild will attempt to resolve a default version. Ad esempio, <Project Sdk="Microsoft.NET.Sdk" /> o <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 Attributo facoltativo.Optional attribute.

Versione del set di strumenti usato da MSBuild per determinare i valori per $(MSBuildBinPath) e $(MSBuildToolsPath).The version of the Toolset MSBuild uses to determine the values for $(MSBuildBinPath) and $(MSBuildToolsPath).
TreatAsLocalProperty Attributo facoltativo.Optional attribute.

Nomi di proprietà che non verranno considerati come globali.Property names that won't be considered to be global. Questo attributo impedisce a proprietà della riga di comando specifiche di eseguire l'override dei valori delle proprietà impostati in un file di progetto o di destinazioni e di tutte le importazioni successive.This attribute prevents specific command-line properties from overriding property values that are set in a project or targets file and all subsequent imports. Per specificare più proprietà, usare il punto e virgola (;) come delimitatore.Multiple properties are semi-colon (;) delimited.

Le proprietà globali in genere eseguono l'override dei valori delle proprietà impostati nel file di progetto o di destinazioni.Normally, global properties override property values that are set in the project or targets file. Se la proprietà è elencata nel valore TreatAsLocalProperty, il valore della proprietà globale non esegue l'override dei valori della proprietà impostati in tale file e delle importazioni successive.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. Per altre informazioni, vedere Procedura: Compilare gli stessi file di origine con opzioni diverse.For more information, see How to: Build the same source files with different options. Nota: Per impostare le proprietà globali al prompt dei comandi, usare l'opzione -property (o -p ).Note: You set global properties at a command prompt by using the -property (or -p) switch. È anche possibile impostare o modificare le proprietà globali per i progetti figlio in una compilazione a più progetti usando l'attributo Properties dell'attività di MSBuild.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. Per altre informazioni, vedere Attività MSBuild.For more information, see MSBuild task.
xmlns Attributo facoltativo.Optional attribute.

Quando specificato, l'attributo xmlns deve avere il valore di http://schemas.microsoft.com/developer/msbuild/2003.When specified, the xmlns attribute must have the value of http://schemas.microsoft.com/developer/msbuild/2003.

Elementi figlioChild elements

ElementoElement DescriptionDescription
ChooseChoose Elemento facoltativo.Optional element.

Valuta gli elementi figlio per selezionare un set di elementi ItemGroup e/o di elementi PropertyGroup da valutare.Evaluates child elements to select one set of ItemGroup elements and/or PropertyGroup elements to evaluate.
ImportImport Elemento facoltativo.Optional element.

Consente a un file di progetto importare un altro file di progetto.Enables a project file to import another project file. Possono esistere zero o più elementi Import in un progetto.There may be zero or more Import elements in a project.
ImportGroupImportGroup Elemento facoltativo.Optional element.

Contiene una raccolta di elementi Import raggruppati in una condizione facoltativa.Contains a collection of Import elements that are grouped under an optional condition.
ItemGroupItemGroup Elemento facoltativo.Optional element.

Elemento di raggruppamento per singoli elementi.A grouping element for individual items. Gli elementi vengono specificati usando l'elemento Item.Items are specified by using the Item element. Possono esistere zero o più elementi ItemGroup in un progetto.There may be zero or more ItemGroup elements in a project.
ItemDefinitionGroupItemDefinitionGroup Elemento facoltativo.Optional element.

Consente di definire un set di definizioni di elementi, ovvero valori di metadati applicati a tutti gli elementi nel progetto per impostazione predefinita.Lets you define a set of Item Definitions, which are metadata values that are applied to all items in the project, by default. ItemDefinitionGroup ovvia alla necessità di usare le attivitàCreateItem e CreateProperty.ItemDefinitionGroup supersedes the need to use the CreateItem task and the CreateProperty task.
ProjectExtensionsProjectExtensions Elemento facoltativo.Optional element.

Consente di rendere permanente informazioni non di MSBuildMSBuild in un file di progetto di MSBuildMSBuild.Provides a way to persist non-MSBuildMSBuild information in an MSBuildMSBuild project file. Possono esistere zero o un elemento ProjectExtensions in un progetto.There may be zero or one ProjectExtensions elements in a project.
PropertyGroupPropertyGroup Elemento facoltativo.Optional element.

Elemento di raggruppamento per singole proprietà.A grouping element for individual properties. Le proprietà vengono specificate usando l'elemento Property.Properties are specified by using the Property element. Possono esistere zero o più elementi PropertyGroup in un progetto.There may be zero or more PropertyGroup elements in a project.
SdkSdk Elemento facoltativo.Optional element.

Fa riferimento a un SDK di progetto MSBuildMSBuild.References an MSBuildMSBuild project SDK. Questo elemento può essere usato come alternativa all'attributo Sdk.This element can be used as an alternative to the Sdk attribute.
DestinazioneTarget Elemento facoltativo.Optional element.

Contiene un set di attività da eseguire in sequenza in MSBuildMSBuild.Contains a set of tasks for MSBuildMSBuild to sequentially execute. Le attività vengono specificate usando l'elemento Task.Tasks are specified by using the Task element. Possono esistere zero o più elementi Target in un progetto.There may be zero or more Target elements in a project.
UsingTaskUsingTask Elemento facoltativo.Optional element.

Consente di registrare attività in MSBuildMSBuild.Provides a way to register tasks in MSBuildMSBuild. Possono esistere zero o più elementi UsingTask in un progetto.There may be zero or more UsingTask elements in a project.

Elementi padreParent elements

Nessuno.None.

Vedere ancheSee also