Parametri di template

Tutti i modelli supportano la sostituzione dei parametri per permettere di sostituire i parametri chiave, come i nomi delle classi e gli spazi dei nomi, quando viene creata un'istanza del modello. Questi parametri vengono sostituiti dalla Creazione guidata modelli che viene eseguita in background quando si fa clic su OK nella finestra di dialogo Nuovo progetto o Aggiungi nuovo elemento.

Dichiarazione e attivazione dei parametri di un modello

I parametri del modello vengono dichiarati nel formato $parametro$. Di seguito è riportato un esempio:

• $safeprojectname$

• $guid1$

• $guid5$

Per attivare la sostituzione dei parametri nei modelli

1. Nel file .vstemplate del modello, individuare l'elemento ProjectItem che corrisponde all'elemento per il quale si desidera attivare la sostituzione dei parametri.

2. Impostare l'attributo ReplaceParameters dell'elemento ProjectItem su true.

3. Nel file di codice dell'elemento del progetto, includere i parametri, se appropriato. Il parametro seguente, ad esempio, specifica che in un file verrà utilizzato safe project name per lo spazio dei nomi:

   namespace $safeprojectname$
   

Parametri di modello riservati

Nella tabella riportata di seguito sono elencati i parametri di modello riservati che possono essere utilizzati con qualsiasi modello.

Parametri di modello personalizzati

Oltre parametri dei modelli riservati che vengono utilizzati automaticamente durante la sostituzione dei parametri, è possibile specificare per i modelli parametri e valori personalizzati. Per ulteriori informazioni, vedere Procedura: passare parametri personalizzati ai modelli.

Esempio: sostituzione dei nomi di file

È possibile specificare nomi di file variabili per elementi del progetto mediante un parametro con l'attributo TargetFileName. È possibile specificare, ad esempio, che il file .exe utilizzi come nome del file il nome del progetto specificato da $projectname$.

<TemplateContent>
    <ProjectItem
        ReplaceParameters="true"
        TargetFileName="$projectname$.exe">
            File1.exe
    </ProjectItem>
      ...
</TemplateContent>

Esempio: utilizzo del nome del progetto per il nome dello spazio dei nomi

Per utilizzare il nome del progetto per il nome dello spazio dei nomi in un file di classe Visual C#, Class1.cs, utilizzare la seguente sintassi:

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;

#endregion

namespace $safeprojectname$
{
    public class Class1
        {
            public Class1()
                {

                }
         }
}

Nel file .vstemplate del modello di progetto, includere il seguente codice XML quando si fa riferimento al file Class1.cs:

<TemplateContent>
    <ProjectItem ReplaceParameters="true">
        Class1.cs
    </ProjectItem>
    ...
</TemplateContent>

Vedere anche

Altre risorse

Modelli di Visual Studio