Condividi tramite

Elemento Project (MSBuild)

  • Articolo

Elemento radice obbligatorio di un file di progetto MSBuild.

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo

Descrizione

DefaultTargets

Attributo facoltativo.

Destinazioni predefinite da utilizzare come punto di ingresso della compilazione se non è stata specificata alcuna destinazione.Se sono specificate più destinazioni, queste sono delimitate da punti e virgola (;).

Se non è specificata alcuna destinazione predefinita nell'attributo DefaultTargets o sulla riga di comando di MSBuild, il motore esegue la prima destinazione del file di progetto dopo aver valutato gli elementi Import.

InitialTargets

Attributo facoltativo.

Destinazioni iniziali che devono essere eseguite prima delle destinazioni specificate nell'attributo DefaultTargets o sulla riga di comando.Se sono specificate più destinazioni, queste sono delimitate da punti e virgola (;).

ToolsVersion

Attributo facoltativo.

La versione del set di strumenti che MSBuild utilizza per determinare i valori per $ (MSBuildBinPath) e $ (MSBuildToolsPath).

TreatAsLocalProperty

Attributo facoltativo.

Nomi di proprietà che non verranno considerati come globali.Questo attributo impedisce le proprietà specifiche della riga di comando da eseguire l'override dei valori delle proprietà impostati in un progetto o un file targets e tutte le importazioni successive.Le proprietà sono più punti e virgola (;) separato.

In genere, le proprietà globali eseguono l'override dei valori delle proprietà impostati nel progetto o nel file targets.Se la proprietà è elencata nel valore TreatAsLocalProperty, il valore della proprietà globale non esegue l'override dei valori di proprietà impostati nel file e tutte le importazioni successive.Per ulteriori informazioni, vedere Procedura: compilare gli stessi file di origine con opzioni diverse.

NotaNota
Le proprietà globali impostate su un prompt dei comandi utilizzando l'opzione /po /property ).È inoltre possibile impostare o modificare le proprietà globali per i progetti figlio in una compilazione di più progetti utilizzando l'attributo Properties dell'attività MSBuild.Per ulteriori informazioni, vedere Attività MSBuild.

Xmlns

Attributo obbligatorio.

L'attributo xmlns deve avere il valore "https://schemas.microsoft.com/developer/msbuild/2003".

Elementi figlio

Elemento

Descrizione

Choose

Elemento facoltativo.

Valuta gli elementi figlio per selezionare un insieme di elementi ItemGroup e/o PropertyGroup da valutare.

Import

Elemento facoltativo.

Consente a un file di progetto di importare un altro file di progetto.In un progetto possono essere presenti zero o più elementi Import.

ItemGroup

Elemento facoltativo.

Elemento di raggruppamento per i singoli elementi.Gli elementi vengono specificati utilizzando l'elemento Item.In un progetto possono essere presenti zero o più elementi ItemGroup.

ProjectExtensions

Elemento facoltativo.

Consente di rendere persistenti le informazioni non appartenenti a MSBuild in un file di progetto MSBuild.In un progetto può essere presente al massimo un elemento ProjectExtensions.

PropertyGroup

Elemento facoltativo.

Elemento di raggruppamento per le singole proprietà.Le proprietà vengono specificate utilizzando l'elemento Property.In un progetto possono essere presenti zero o più elementi PropertyGroup.

Destinazione

Elemento facoltativo.

Contiene un insieme di attività da eseguire in sequenza in MSBuild.Le attività vengono specificate utilizzando l'elemento Task.In un progetto possono essere presenti zero o più elementi Target.

UsingTask

Elemento facoltativo.

Consente di registrare le attività in MSBuild.In un progetto possono essere presenti zero o più elementi UsingTask.

Elementi padre

Nessuno.

Vedere anche

Attività

Procedura: specificare quale destinazione compilare per prima

Riferimenti

Riferimenti alla riga di comando di MSBuild

Concetti

Riferimenti dello schema del file di progetto MSBuild

Altre risorse

MSBuild