Condividi tramite

Creare modelli di elemento

Questo articolo illustra come creare un modello di elemento usando la procedura guidata Esporta modello o manualmente e come modificare e usare i modelli di elemento. Se il modello è costituito da più file, vedere anche Procedura: Creare modelli di elementi multi-file.

Aggiungere un modello di elemento

  1. Creare o aprire un progetto in Visual Studio.

  2. Selezionare Progetto>Aggiungi nuovo elemento o premere CTRL+MAIUSC+A.

  3. Nella finestra di dialogo Aggiungi nuovo elemento selezionare un elemento e quindi selezionare Aggiungi per aggiungerlo al progetto.

  4. Modifica l'elemento secondo le esigenze e indica dove, all'interno dell'elemento, dovrebbe avvenire la sostituzione dei parametri, se necessario. Per altre informazioni, vedere Procedura: Sostituire i parametri in un modello.

  5. Salva l'elemento.

  6. Selezionare Progetto>Modello di esportazione. Si apre la Procedura guidata per l'esportazione di modelli.

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

  8. Nella pagina Seleziona elemento da esportare scegliere l'elemento per cui si vuole creare un modello e quindi selezionare Avanti.

  9. Nella pagina Seleziona riferimenti elemento selezionare i riferimenti all'assembly da includere nel modello e quindi selezionare Avanti.

  10. Nella pagina Selezione opzioni modello :

    • Immettere il nome del modello e la descrizione facoltativa, l'immagine dell'icona e l'immagine di anteprima.

      I file icona per gli elementi sono .ico file, come descritto in Immagini e icone per Visual Studio. L'immagine di anteprima è un'immagine 200 x 200 visualizzata nella finestra di dialogo Aggiungi nuovo elemento . È possibile scaricare la libreria di immagini di Visual Studio per ottenere icone coerenti con lo stile di Visual Studio.

    • Selezionare se importare automaticamente il modello in Visual Studio e Visualizzare una finestra di esplorazione nella cartella dei file di output.

  11. Selezionare Fine.

I file modello vengono compressi in un file.zip e copiati nella directory visualizzata nella procedura guidata in Percorso di output. Il percorso predefinito è %USERPROFILE%\Documents\Visual Studio version\My Exported Templates.The default location is%USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

Se è stata selezionata l'opzione Importa automaticamente il modello in Visual Studio, il file .zip viene aggiunto anche alla directory ItemTemplates dell'utente. Il percorso predefinito è %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

È ora possibile usare il modello di elemento nei progetti.

Usare il modello dell'elemento

  1. Se non è stata selezionata l'opzione Importa automaticamente il modello in Visual Studio al momento della creazione del modello, copiare il file.zip nella directory ItemTemplates . Il percorso predefinito è %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Chiudere Visual Studio e riaprirlo.
  3. Creare un nuovo progetto o aprire un progetto esistente e selezionare Progetto>Aggiungi nuovo elemento
  4. Selezionare il modello di elemento nella finestra di dialogo Aggiungi nuovo elemento . Se è stata aggiunta una descrizione nella Procedura guidata Esporta modello, la descrizione viene visualizzata sul lato destro della finestra di dialogo.
  5. Selezionare Aggiungi per aggiungere l'elemento modello al progetto.

Modificare il file .vstemplate

La procedura guidata crea un modello di base, ma in alcuni casi è necessario modificare manualmente il file con estensione vstemplate dopo l'esportazione del modello. Ad esempio, se vuoi che l'elemento venga visualizzato nella finestra di dialogo Aggiungi nuovo elemento per un progetto di App universale di Windows, devi modificare il file .vstemplate.

  1. Estrarre il modello di elemento esportato .zip file e aprire il file con estensione vstemplate in Visual Studio.
  2. Modificare il file in base alle esigenze. Per un progetto di Windows universale C#, aggiungere <TemplateID>Microsoft.CSharp.Class</TemplateID> all'interno dell'elemento <TemplateData> .
  3. Salvare e chiudere il file vstemplate e sostituirlo nel file .zip .

Abilitare i modelli per sottotipi di progetto specifici

È possibile modificare il file con estensione vstemplate per specificare che il modello di elemento viene visualizzato solo per determinati sottotipi di progetto, ad esempio Windows, Office, Database o Web.

  1. Aprire il file con estensione vstemplate per la modifica.
  2. Aggiungere un elemento ProjectSubType immediatamente dopo l'elemento ProjectType , con valore Windows, OfficeDatabase, o Web. Ad esempio: <ProjectSubType>Database</ProjectSubType>.

L'esempio seguente mostra un file .vstemplate per progetti.

<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

Anziché usare la procedura guidata, è possibile creare manualmente un modello di elemento da zero.

  1. Creare un progetto e aggiungere un elemento.
  2. Modificare l'elemento in base alle esigenze, ad esempio aggiungendo dove deve essere eseguita una sostituzione dei parametri e salvare l'elemento.
  3. Creare un file XML e salvarlo con un'estensione di file vstemplate nella stessa directory del file dell'elemento di progetto.
  4. Aggiungere i metadati del modello di elemento al file XML denominato .vstemplate, come illustrato nell'esempio precedente. Per altre informazioni, vedere Informazioni di riferimento sullo schema del modello (estendibilità).
  5. Salvare e chiudere il file vstemplate .
  6. In l'Esplora file, seleziona i file da includere nel modello, incluso il file con estensione .vstemplate. Fare clic con il pulsante destro del mouse sulla selezione e scegliere Comprimi in>file ZIP.
  7. Copiare il file .zip risultante e incollarlo nel percorso del modello di elemento utente di Visual Studio. La directory predefinita è %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Contenuti correlati

  • Last updated on