Creare modelli di progetto ed elemento personalizzati

L Visual Studio SDK include modelli di progetto che creano un modello di progetto personalizzato e un modello di elemento personalizzato. Questi modelli includono alcune sostituzioni di parametri comuni e vengono compilati come file ZIP. Non vengono distribuiti automaticamente e non sono disponibili nell'istanza sperimentale. È necessario copiare il file ZIP generato nella directory del modello utente.

I modelli di creazione dei modelli consentono di includere modelli in estensioni più grandi. In questo modo è possibile implementare il controllo della versione nei file di origine e compilare un gruppo di progetti modello in un unico pacchetto VSIX.

È anche possibile configurare un modello per installare NuGet pacchetti. Per altre informazioni, vedere NuGet pacchetti in Visual Studio modelli.

Per gli scenari di creazione di modelli di base, è consigliabile usare l'Esportazione guidata modelli, che restituisce l'output in un file compresso. Per altre informazioni sulla creazione di modelli di base, vedere Creazione di modelli di progetto ed elemento.

Nota

A partire Visual Studio 2017, l'analisi dei modelli di progetto ed elemento personalizzati non verrà più eseguita. Al contrario, l'estensione deve fornire file manifesto del modello che descrivono il percorso di installazione di questi modelli. È possibile usare Visual Studio 2017 per aggiornare le estensioni VSIX. Se si distribuisce l'estensione usando un'estensione MSI, è necessario generare manualmente i file manifesto del modello. Per altre informazioni, vedere Upgrading custom project and item templates for Visual Studio 2017 (Aggiornamentodi modelli di progetto ed elementi personalizzati per Visual Studio 2017). Lo schema del manifesto del modello è documentato nell'Visual Studio dello schema del manifesto del modello.

Creare un modello di progetto

  1. Creare un Project modello personalizzato. È possibile trovare il modello di progetto nella finestra di dialogo Nuovo Project, cercando "modello di progetto" e selezionando la versione C# o Visual Basic progetto.

    Il modello genera un file di classe, un'icona, un file con estensione vstemplate, un file di progetto modificabile denominato ProjectTemplate.vbproj o ProjectTemplate.csproj e alcuni file in genere generati da altri tipi di progetto, ad esempio un file resources.resx, un file AssemblyInfo e un file con estensione settings. Ogni file di codice contiene sostituzioni di parametri comuni, dove appropriato.

Selezione del progetto modello di progetto

  1. Aggiungere e rimuovere elementi dal progetto come richiesto per il progetto. Non rimuovere il file di progetto modificabile, il file AssemblyInfo o il file con estensione vstemplate.

  2. Aggiornare il file con estensione vstemplate per riflettere eventuali aggiunte ed eliminazioni. L Project elemento deve contenere un elemento ProjectItem per ogni file da includere nel modello.

  3. Modificare i file di codice e altro contenuto rivolto all'utente e aggiungere le sostituzioni di parametri appropriate.

  4. Modificare il contenuto generato in base alle esigenze.

  5. Compilare il progetto.

    Visual Studio crea un .zip file contenente il modello. Non viene distribuito e non è disponibile nell'istanza sperimentale.

Creare un modello di elemento

  1. Creare un progetto modello di elemento.

    Il modello genera un file di classe, un'icona, un file con estensione vstemplate e un file AssemblyInfo. Il file di classe contiene alcune sostituzioni di parametri comuni.

  2. Aggiungere e rimuovere elementi dal progetto come richiesto per il progetto.

  3. Aggiornare il file con estensione vstemplate per riflettere eventuali aggiunte ed eliminazioni. L Project elemento deve contenere un elemento ProjectItem per ogni file da includere nel modello.

  4. Modificare i file di codice e altro contenuto rivolto all'utente e aggiungere le sostituzioni di parametri appropriate.

  5. Modificare il contenuto generato in base alle esigenze.

  6. Compilare il progetto.

    Visual Studio crea un file compresso che contiene il modello. Non viene distribuito e non è disponibile nell'istanza sperimentale.

Distribuzione

Per distribuire il progetto o il modello di elemento

  1. Creare un progetto VSIX. Per altre informazioni, vedere Modello di progetto VSIX.

  2. Impostare il progetto VSIX come progetto di avvio. Nella finestra Esplora soluzioni selezionare il nodo del progetto VSIX, fare clic con il pulsante destro del mouse e scegliere Imposta come avvio Project .

  3. Impostare il progetto modello di progetto come asset del progetto VSIX. Aprire il file con estensione vsixmanifest. Passare alla scheda Asset e selezionare Nuovo.

    1. Impostare il campo Tipo su Microsoft.VisualStudio.ProjectTemplate o Microsoft.VisualStudio.ItemTemplate.

    2. Per origine, selezionare l'opzione Un progetto nella soluzione corrente e quindi selezionare il progetto che contiene il modello.

  4. Compilare la soluzione e premere F5. Viene visualizzata l'istanza sperimentale.

  5. Per un progetto di modello di progetto, il modello di progetto dovrebbe essere elencato nella finestra di dialogo Nuovo Project (File Nuovo Project ), nel nodo > > Visual C# o Visual Basic progetto. Per un progetto di modello di elemento, il modello di elemento dovrebbe essere elencato nella finestra di dialogo Aggiungi nuovo elemento. Per visualizzare la finestra di dialogo Aggiungi nuovo elemento, nella Esplora soluzioni selezionare il nodo del progetto e selezionare Aggiungi nuovo > elemento.

Vedi anche