Creare modelli di elementi

  • Articolo

Questo argomento spiega come creare un modello di elemento usando l'Esportazione guidata modelli. Se il modello è costituito da più file, vedere Procedura: Creare modelli di elementi a più file.

Aggiungere un modello di elemento alla finestra di dialogo Aggiungi nuovo elemento

  1. Creare o aprire un progetto in Visual Studio.

  2. Aggiungere un elemento al progetto e modificarlo, se necessario.

  3. Modificare il file del codice per indicare dove verrà applicata la sostituzione dei parametri. Per altre informazioni, vedere Procedura: Sostituire i parametri di un modello.

  4. Nel menu Progetto scegliereEsporta modello.

  5. Nella pagina Scegliere il tipo di modello scegliere Modello di elemento, selezionare il progetto che contiene l'elemento e quindi scegliere Avanti.

  6. Nella pagina Selezionare elemento da esportare scegliere l'elemento per cui si vuole creare un modello e quindi scegliere Avanti.

  7. Nella pagina Selezionare i riferimenti dell'elemento selezionare i riferimenti all'assembly da includere nel modello e quindi scegliere Avanti.

  8. Nella pagina Selezionare le opzioni del modello immettere il nome del modello ed eventualmente una descrizione, un'icona e un'immagine di anteprima, quindi scegliere Fine. I file icona per gli elementi sono .ico file, come descritto in Immagini e icone per Visual Studio - Tipi di file. L'immagine di anteprima è un'immagine 200 x 200 che verrà visualizzata nella finestra di dialogo Aggiungi nuovo elemento .

    È possibile cercare le icone coerenti con lo stile di Visual Studio nella libreria di immagini di Visual Studio.

    I file per il modello vengono aggiunti a un file con estensione zip e copiati nella directory specificata nella procedura guidata. Il percorso predefinito è %USERPROFILE%\Documents\Visual Studio <versione>\My Exported Templates.

  9. Se non è stata selezionata l'opzione Importa automaticamente il modello in Visual Studio nell'Esportazione guidata modelli, individuare il modello esportato. Quindi, copiarlo nella directory di modello di elemento utente. Il percorso predefinito è %USERPROFILE%\Documents\Visual Studio <versione>\Templates\ItemTemplates.

  10. Chiudere e riaprire Visual Studio.

  11. Creare un nuovo progetto o aprire un progetto esistente, quindi scegliere Progetto>Aggiungi nuovo elemento o premere CTRL+MAIUSC+A.

    Il modello di elemento appare nella finestra di dialogo Aggiungi nuovo elemento. Se è stata aggiunta una descrizione nell'Esportazione guidata modelli, la descrizione viene visualizzata sul lato destro della finestra di dialogo.

Abilitare l'uso del modello di elemento in un progetto di app di Windows universale

La procedura guidata esegue la maggior parte delle operazioni richieste per creare un modello di base, ma in molti casi sarà necessario modificare manualmente il file con estensione vstemplate dopo aver esportato il modello. Ad esempio, se si vuole includere l'elemento nella finestra di dialogoAggiungi nuovo elemento per un progetto di app di Windows universale, è necessario eseguire alcuni passaggi aggiuntivi.

  1. Seguire i passaggi della sezione precedente per esportare un modello di elemento.

  2. Estrarre il file con estensione zip creato e aprire il file con estensione vstemplate in Visual Studio.

  3. Per un progetto C# di Windows universale, aggiungere il codice XML seguente all'interno dell'elemento <TemplateData>:

    <TemplateID>Microsoft.CSharp.Class</TemplateID>

  4. In Visual Studio salvare e chiudere il file con estensione vstemplate.

  5. Copiare e incollare il file con estensione vstemplate nel file con estensione zip.

    Se viene visualizzata la finestra di dialogo Copia file, selezionare l'opzione Copia e sostituisci.

È ora possibile aggiungere un elemento basato su questo modello a un progetto di Windows universale dalla finestra di dialogo Aggiungi nuovo elemento.

Abilitare i modelli per sottotipi di progetto specifici

È possibile specificare che il modello deve essere visualizzato solo per determinati sottotipi di progetto, ad esempio Windows, Office, Database o Web.

  1. Individuare l'elemento ProjectType nel file con estensione vstemplate per il modello di elemento.

  2. Aggiungere un elemento ProjectSubType immediatamente dopo l'elemento ProjectType.

  3. Impostare il valore di testo dell'elemento su uno dei valori seguenti:

    • Windows
    • Office
    • Database
    • Web

Ad esempio: <ProjectSubType>Database</ProjectSubType>.

L'esempio seguente illustra un modello di elemento per i progetti Office.

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

Creare manualmente un modello di elemento

In alcuni casi può essere utile creare manualmente un modello di elemento da zero.

  1. Creare un progetto e un elemento di progetto.

  2. Modificare l'elemento di progetto finché non è pronto per essere salvato come modello.

  3. Modificare il file del codice per indicare dove deve avvenire la sostituzione dei parametri, se necessaria. Per altre informazioni sulla sostituzione dei parametri, vedere Procedura: Sostituire i parametri di un modello.

  4. Creare un file XML e salvarlo con estensione vstemplate nella stessa directory del file dell'elemento del progetto.

  5. Modificare il file XML con estensione vstemplate in modo da specificare i metadati del modello di elemento. Per altre informazioni, vedere Riferimento allo schema di modello (estendibilità) e l'esempio nella sezione precedente.

  6. Salvare e chiudere il file con estensione vstemplate.

  7. In Esplora risorse selezionare i file che si vuole includere nel modello. Fare clic con il pulsante destro del mouse sulla selezione e scegliere Invia a>Cartella compressa. I file selezionati verranno compressi in un file con estensione zip.

  8. Copiare il file con estensione zip e incollarlo nel percorso dei modelli di elemento dell'utente. La directory predefinita è %U edizione Standard RPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates. Per altre informazioni, vedere Procedura: Individuare e organizzare modelli di progetto e modelli di elementi.

Contenuto correlato