Elemento Project (MSBuild)

  • Articolo

Elemento radice obbligatorio di un file di progetto MSBuild.

Sintassi

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

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

Attributi

Attributo Descrizione
DefaultTargets Attributo facoltativo.

Destinazione o destinazioni predefinite che saranno il punto di ingresso della compilazione se non è stata specificata alcuna destinazione. Per specificare più destinazioni, usare il punto e virgola (;) come delimitatore.

Se non viene specificata alcuna destinazione predefinita nell'attributo DefaultTargets o nella riga di comando di MSBuild, il motore esegue la prima destinazione nel file di progetto dopo la valutazione degli elementi Import .
InitialTargets Attributo facoltativo.

Destinazione o destinazioni iniziali da eseguire prima delle destinazioni specificate nell'attributo DefaultTargets o nella riga di comando. Per specificare più destinazioni, usare il punto e virgola (;) come delimitatore. Se più file importati definiscono InitialTargets, tutte le destinazioni menzionate verranno eseguite nell'ordine in cui si rilevano le importazioni.
Sdk Attributo facoltativo.

Nome e versione facoltativa dell'SDK da usare per creare istruzioni Import implicite che vengono aggiunte al file PROJ. Se non viene specificata alcuna versione, MSBuild tenterà di risolvere una versione predefinita. Ad esempio, <Project Sdk="Microsoft.NET.Sdk" /> o <Project Sdk="My.Custom.Sdk/1.0.0" />.
ToolsVersion Attributo facoltativo.

Versione del set di strumenti usato da MSBuild per determinare i valori per $(MSBuildBinPath) e $(MSBuildToolsPath).
TreatAsLocalProperty Attributo facoltativo.

Nomi di proprietà che non verranno considerati come globali. 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. Per specificare più proprietà, usare il punto e virgola (;) come delimitatore.

Le proprietà globali in genere eseguono l'override dei valori delle proprietà impostati nel file di progetto o di destinazioni. 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. Per altre informazioni, vedere Procedura: Compilare gli stessi file di origine con opzioni diverse. Nota: per impostare le proprietà globali al prompt dei comandi, usare l'opzione -property (o -p). È 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. Per altre informazioni, vedere Attività MSBuild.
xmlns Attributo facoltativo.

Quando specificato, l'attributo xmlns deve avere il valore di http://schemas.microsoft.com/developer/msbuild/2003.

Elementi figlio

Elemento Descrizione
Scegliere Elemento facoltativo.

Valuta gli elementi figlio per selezionare un set di elementi ItemGroup e/o di elementi PropertyGroup da valutare.
Importa Elemento facoltativo.

Consente a un file di progetto importare un altro file di progetto. Possono esistere zero o più elementi Import in un progetto.
ImportGroup Elemento facoltativo.

Contiene una raccolta di elementi Import raggruppati in una condizione facoltativa.
ItemGroup Elemento facoltativo.

Elemento di raggruppamento per singoli elementi. Gli elementi vengono specificati usando l'elemento Item. Possono esistere zero o più elementi ItemGroup in un progetto.
ItemDefinitionGroup Elemento facoltativo.

Consente di definire un set di definizioni di elementi, ovvero valori di metadati applicati a tutti gli elementi nel progetto per impostazione predefinita. ItemDefinitionGroup ovvia alla necessità di usare le attivitàCreateItem e CreateProperty.
ProjectExtensions Elemento facoltativo.

Fornisce un modo per rendere persistenti le informazioni non MSBuild in un file di progetto MSBuild. Possono esistere zero o un elemento ProjectExtensions in un progetto.
PropertyGroup Elemento facoltativo.

Elemento di raggruppamento per singole proprietà. Le proprietà vengono specificate usando l'elemento Property. Possono esistere zero o più elementi PropertyGroup in un progetto.
Sdk Elemento facoltativo.

Fa riferimento a un SDK di progetto MSBuild. Questo elemento può essere usato come alternativa all'attributo Sdk.
Destinazione Elemento facoltativo.

Contiene un set di attività per l'esecuzione sequenziale di MSBuild. Le attività vengono specificate usando l'elemento Task. Possono esistere zero o più elementi Target in un progetto.
UsingTask Elemento facoltativo.

Consente di registrare le attività in MSBuild. Possono esistere zero o più elementi UsingTask in un progetto.

Elementi padre

Nessuno.

Vedi anche