Procedura: individuare e organizzare modelli di progetto e modelli di elementi

Articolo
09/12/2008

Aggiornamento: novembre 2007

I file di modello devono essere inseriti in un percorso riconosciuto da Visual Studio in modo da poterli visualizzare nelle finestre di dialogo Nuovo progetto e Aggiungi nuovo elemento. Per i modelli è possibile creare delle sottocategorie personalizzate che verranno poi visualizzate nell'interfaccia utente.

Individuazione dei modelli

Per impostazione predefinita, in Visual Studio i modelli di progetto e i modelli di elemento vengono cercati in due percorsi. Se in questi percorsi esiste un file compresso che contiene un file .vstemplate, nella finestra di dialogo Nuovo progetto o Aggiungi nuovo elemento verrà visualizzato il rispettivo modello.

Modelli installati

Per impostazione predefinita, i modelli installati con il prodotto risiedono nei seguenti percorsi:

<VisualStudioInstallDir>\\Common7\\IDE\\ItemTemplates\\Language\\Locale\\
<VisualStudioInstallDir>\\Common7\\IDE\\ProjectTemplates\\Language\\Locale\\

La directory seguente, ad esempio, contiene tutti i modelli di progetto di Visual Studio per l'inglese:

C:\Programmi\Microsoft Visual Studio 9,0\Common7\IDE\ItemTemplates\VisualBasic\1033\

Modelli personalizzati

Per impostazione predefinita, i modelli personalizzati risiedono nel seguente percorso:

Documenti\Visual Studio 2008\Templates\ProjectTemplates\Language\
Documenti\Visual Studio 2008\Templates\ItemTemplates\Language\

La directory seguente, ad esempio, contiene i modelli di progetto personalizzati di Visual C#:

C:\Documents and Settings\Nome Utente\Documenti\Visual Studio 2008\ProjectTemplates\Visual C#\

I modelli personalizzati non includono una sottodirectory per i modelli localizzati. Per modificare la directory predefinita dei modelli personalizzati, utilizzare la finestra di dialogo Opzioni. Per ulteriori informazioni, vedere la classe Finestra di dialogo Opzioni, Progetti e soluzioni, Generale.

Organizzazione dei modelli

Le categorie nelle finestre di dialogo Nuovo progetto e Aggiungi nuovo elemento riflettono le strutture delle directory ubicate nei percorsi dei modelli installati e dei modelli personalizzati. È possibile modificare le strutture di queste directory e organizzare i modelli in base alle esigenze.

Nota:
Non è possibile creare una nuova categoria a livello di linguaggio di programmazione. Le nuove categorie possono essere create solo all'interno di ciascun linguaggio.

Se le directory dei modelli installati e personalizzati di un particolare linguaggio non presentano la stessa struttura, ovvero se esistono, ad esempio, alcune directory sotto una cartella che non esistono sotto l'altra cartella, nella finestra di dialogo Nuovo progetto l'insieme delle categorie verrà visualizzato come un'unione di tutte le categorie.

Organizzazione dei modelli installati

È possibile organizzare i modelli installati creando delle sottodirectory all'interno della cartella del linguaggio di programmazione. Nelle finestre di dialogo Nuovo progetto e Aggiungi nuovo elemento queste sottodirectory verranno rappresentate come cartelle virtuali all'interno di ciascun linguaggio.

Per creare nuove categorie dei modelli di progetto installati

Creare una nuova cartella nella cartella del linguaggio della directory dei modelli installati. Per creare, ad esempio, una categoria Office per i modelli di progetto di Visual Studio, è necessario creare la directory seguente:

<VisualStudioInstallDir>\Common7\IDE\ProjectTemplates\VisualBasic\Office
Inserire nella nuova cartella tutti modelli di questa categoria.
Chiudere tutte le istanze di Visual Studio.
Nel menu Start, scegliere Esegui, digitare "cmd", quindi fare clic su OK.
Al prompt dei comandi, passare alla directory che contiene devenv.exe e digitare "devenv /setup".
Eseguire Visual Studio.
Scegliere Nuovo dal menu File, quindi Progetto.
Verificare che la categoria Office sia visualizzata sotto Visual Basic nel riquadro Tipi progetto della finestra di dialogo Nuovo progetto.

In modo simile, è possibile raggruppare in una cartella personalizzata un sottoinsieme dei modelli degli elementi del progetto.

Per creare nuove categorie dei modelli di elemento installati

Creare una nuova cartella nella cartella del linguaggio della directory dei modelli installati. Per creare, ad esempio, una categoria Web per i modelli di elemento di Visual C#, è necessario creare la directory seguente:

<VisualStudioInstallDir>\Common7\IDE\ItemTemplates\CSharp\Web\
Inserire nella nuova cartella tutti modelli di questa categoria.
Chiudere tutte le istanze di Visual Studio.
Nel menu Start, scegliere Esegui, digitare "cmd", quindi fare clic su OK.
Al prompt dei comandi, passare alla directory che contiene devenv.exe e digitare "devenv /setup".
Eseguire Visual Studio.
Creare un nuovo progetto o aprire un progetto esistente.
Scegliere Aggiungi nuovo elemento dal menu Progetto.
Verificare che la categoria Web sia visualizzata nel riquadro Tipi progetto della finestra di dialogo Aggiungi nuovo elemento.

Organizzazione dei modelli personalizzati

È possibile organizzare i modelli personalizzati in categorie proprie aggiungendo nuove cartelle nel percorso dei modelli personalizzati. La finestra di dialogo Nuovo progetto riflette tutte le modifiche apportate alle categorie dei modelli.

Per creare nuove categorie di modelli di progetto personalizzati

Creare una nuova cartella nella cartella del linguaggio della directory dei modelli di progetto personalizzati. Per creare, ad esempio, una categoria HelloWorld per i modelli Visual C#, è necessario creare la directory seguente:

Documenti\Visual Studio 2008\Templates\ProjectTemplates\CSharp\HelloWorld\
Inserire nella nuova cartella tutti modelli di questa categoria.
Scegliere Nuovo dal menu File, quindi Progetto.
Verificare che la categoria HelloWorld sia visualizzata sotto Visual C# nel riquadro Tipi progetto della finestra di dialogo Nuovo progetto.

In modo simile, è possibile raggruppare in una cartella personalizzata un sottoinsieme dei modelli di elemento personalizzati.

Per creare nuove categorie di modelli di elemento personalizzati

Creare una nuova cartella nella cartella del linguaggio della directory dei modelli di elemento personalizzati. Per creare, ad esempio, una categoria HelloWorld per i modelli Visual C#, è necessario creare la directory seguente:

Documenti\Visual Studio 2008\Templates\ItemTemplates\CSharp\HelloWorld\
Inserire nella nuova cartella tutti modelli di questa categoria.
Creare un nuovo progetto o aprire un progetto esistente.
Scegliere Aggiungi nuovo elemento dal menu Progetto.
Verificare che la categoria HelloWorld sia visualizzata nel riquadro Tipi progetto della finestra di dialogo Aggiungi nuovo elemento.

Visualizzazione dei modelli in categorie principali

I modelli inclusi nelle sottocategorie possono essere visualizzati nelle relative categorie principali tramite l'elemento NumberOfParentCategoriesToRollUp incluso nel file .vstemplate. Questa procedura è identica sia per i modelli di progetto che per i modelli di elemento.

Per visualizzare i modelli in categorie principali

Individuare il file .zip che contiene il modello.
Estrarre il file .zip.
Aprire il file .vstemplate in Visual Studio.
Nell'elemento TemplateData, aggiungere un elemento NumberOfParentCategoriesToRollUp. Il codice riportato di seguito, ad esempio, rende visibile il modello nella categoria principale, ma non in un livello superiore:
```
<TemplateData>
    ...
    <NumberOfParentCategoriesToRollUp>
        1
    </NumberOfParentCategoriesToRollUp>
    ...
</TemplateData>
```
Salvare e chiudere il file .vstemplate.
Selezionare i file inclusi nel modello, fare clic con il pulsante destro del mouse, scegliere Invia a, quindi fare clic su Cartella compressa. I file selezionati verranno compressi in un file .zip.
Eliminare i file di modello estratti e il vecchio file di modello .zip.
Inserire il nuovo file .zip nella stessa directory del file .zip eliminato.