Elemento Project (modelli di Visual Studio)

Articolo
06/10/2015

Specifica i file o le directory da aggiungere al progetto.

<Project
    File="MyProject.proj"
    TargetFileName="MyTargetProject.proj"
    ReplaceParameters="true/false">
    IgnoreProjectParameter="$myCustomParameter$"
        ...
</Project>

Attributi ed elementi

Nelle seguenti sezioni sono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
File	Attributo obbligatorio. Specifica il nome del file di progetto incluso nel file .zip del modello.
ReplaceParameters	Attributo facoltativo. Un valore booleano che specifica se nel file di progetto i valori dei parametri dovranno essere sostituiti quando viene creato un progetto dal modello. Il valore predefinito è false.
TargetFileName	Attributo facoltativo. Specifica il nome del file di progetto quando viene creato un progetto dal modello.
IgnoreProjectParameter	Attributo facoltativo. Specifica se il progetto deve essere aggiunto alla soluzione corrente. Se il valore di parametro personalizzato, “$myCustomParameter$„ esiste nel file di sostituzione parametro, il progetto viene creato ma non viene aggiunta come parte della soluzione.

Elementi figlio

Elemento	Descrizione
Cartella	Elemento facoltativo. Specifica una cartella da aggiungere al progetto.
ProjectItem	Elemento facoltativo. Specifica un file da aggiungere a un progetto.

Cartella

Elemento facoltativo.

Specifica una cartella da aggiungere al progetto.

ProjectItem

Elemento facoltativo.

Specifica un file da aggiungere a un progetto.

Elementi padre

Elemento	Descrizione
TemplateContent	Elemento obbligatorio.

Note

Project è un elemento figlio facoltativo di TemplateContent.

L'elemento Project viene utilizzato per specificare un progetto e pertanto è valido solo nei modelli di progetto.

Gli elementi Project possono avere elementi figli Folder o elementi figli ProjectItem ma non un insieme di entrambi gli elementi figli Folder e ProjectItem.

In Visual Studio il file di progetto viene rinominato automaticamente in base al nome specificato dall'utente nella finestra di dialogo Nuovo progetto. Se si desidera fornire un nome di file alternativo per i file di progetto creati con il modello, utilizzare l'attributo TargetFileName.

Esempio

Nell'esempio riportato di seguito vengono illustrati i metadati per un modello di progetto di un'applicazione di Visual C#.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>