Freigeben über

Erstellen von Elementvorlagen

In diesem Artikel erfahren Sie, wie Sie eine Elementvorlage mithilfe des Assistenten zum Exportieren von Vorlagen oder manuell erstellen und wie Sie Elementvorlagen bearbeiten und verwenden. Wenn Ihre Vorlage aus mehreren Dateien besteht, finden Sie weitere Informationen unter Gewusst wie: Erstellen von Elementvorlagen mit mehreren Dateien.

Hinzufügen einer Elementvorlage

  1. Erstellen oder öffnen Sie ein Projekt in Visual Studio.

  2. Wählen Sie Projekt>Neues Element hinzufügen aus, oder drücken Sie Strg+, Umschalt+A.

  3. Wählen Sie im Dialogfeld Neues Element hinzufügen ein Element aus, und wählen Sie dann Hinzufügen aus, um es dem Projekt hinzuzufügen.

  4. Ändern Sie das Element wie gewünscht, und geben Sie an, wo im Element die Parameterersetzung stattfinden soll. Weitere Informationen finden Sie unter How to: Substitute parameters in a template.

  5. Speichern Sie das Element.

  6. Wählen SieProjektexportvorlage> aus. Der Assistent zum Exportieren von Vorlagen wird geöffnet.

  7. Wählen Sie auf der Seite Vorlagentyp auswählen die Option Elementvorlage aus, wählen Sie das Projekt aus, das das Element enthält, und wählen Sie dann Weiter aus.

  8. Wählen Sie auf der Seite Zu exportierendes Element auswählen das Element aus, für das Sie eine Vorlage erstellen möchten, und wählen Sie dann Weiter aus.

  9. Wählen Sie auf der Seite Elementverweise auswählen alle Assemblyverweise aus, die in die Vorlage aufgenommen werden sollen, und wählen Sie dann Weiter aus.

  10. Gehen Sie auf der Seite Vorlagenoptionen auswählen wie folgt vor:

    • Geben Sie den Vorlagennamen und die optionale Beschreibung, das Symbolbild und das Vorschaubild ein.

      Symboldateien für Elemente sind .ico Dateien, wie unter Bilder und Symbole für Visual Studio beschrieben. Das Vorschaubild ist ein Bild im Format 200 x 200, das im Dialogfeld Neues Element hinzufügen angezeigt wird. Sie können die Visual Studio-Bildbibliothek herunterladen, um Symbole zu erhalten, die mit dem Visual Studio-Stil konsistent sind.

    • Wählen Sie aus, ob die Vorlage automatisch in Visual Studio importiert werden soll, und zeigen Sie ein Explorer-Fenster im Ausgabedateiordner an.

  11. Klicken Sie auf Fertig stellen.

Die Vorlagendateien werden in eine .zip Datei komprimiert und in das Verzeichnis kopiert, das im Assistenten unter Ausgabespeicherort angezeigt wird. Der Standardspeicherort ist %USERPROFILE%\Dokumente\Visual Studio-Version<>\Eigene exportierte Vorlagen.

Wenn Sie Vorlage automatisch in Visual Studio importieren ausgewählt haben, wird die .zip Datei auch dem ItemTemplates-Benutzerverzeichnis hinzugefügt. Der Standardspeicherort ist %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Sie können die Elementvorlage jetzt in Ihren Projekten verwenden.

Verwenden der Elementvorlage

  1. Wenn Sie beim Erstellen der Vorlage nicht die Option Vorlage automatisch in Visual Studio importieren ausgewählt haben, kopieren Sie die .zip Datei in das Verzeichnis ItemTemplates . Der Standardspeicherort ist %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Schließen Sie Visual Studio, und öffnen Sie es erneut.
  3. Erstellen Sie ein neues Projekt, oder öffnen Sie ein vorhandenes Projekt, und wählen Sie Projekt>Neues Element hinzufügen aus.
  4. Wählen Sie die Elementvorlage im Dialogfeld Neues Element hinzufügen aus. Wenn Sie im Assistenten zum Exportieren von Vorlagen eine Beschreibung hinzugefügt haben, wird die Beschreibung auf der rechten Seite des Dialogfelds angezeigt.
  5. Wählen Sie Hinzufügen aus, um das Vorlagenelement zu Ihrem Projekt hinzuzufügen.

Bearbeiten der VSTEMPLATE-Datei

Der Assistent erstellt eine einfache Vorlage, aber in einigen Fällen müssen Sie die VSTEMPLATE-Datei manuell ändern, nachdem Sie die Vorlage exportiert haben. Wenn das Element z. B. im Dialogfeld "Neues Element hinzufügen " für ein Projekt für eine universelle Windows-App angezeigt werden soll, müssen Sie die VSTEMPLATE-Datei bearbeiten.

  1. Extrahieren Sie die exportierte Elementvorlage .zip Datei, und öffnen Sie die VSTEMPLATE-Datei in Visual Studio.
  2. Bearbeiten Sie die Datei nach Bedarf. Fügen Sie für ein universelles C#-Windows-Projekt innerhalb des <TemplateData> Elements hinzu<TemplateID>Microsoft.CSharp.Class</TemplateID>.
  3. Speichern und schließen Sie die VSTEMPLATE-Datei , und ersetzen Sie sie in der .zip Datei.

Aktivieren von Vorlagen für bestimmte Projektuntertypen

Sie können die VSTEMPLATE-Datei bearbeiten, um anzugeben, dass die Elementvorlage nur für bestimmte Projektuntertypen angezeigt wird, z. B. Windows, Office, Datenbank oder Web.

  1. Öffnen Sie die VSTEMPLATE-Datei zur Bearbeitung.
  2. Fügen Sie unmittelbar nach dem Element ein ProjectSubType-Element mit dem ProjectType Wert Windows, Office, Databaseoder Web. Beispiel: <ProjectSubType>Database</ProjectSubType>.

Das folgende Beispiel zeigt eine VSTEMPLATE-Datei für Office Projekte.

<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>

Manuelles Erstellen einer Elementvorlage

Anstatt den Assistenten zu verwenden, können Sie eine Elementvorlage manuell von Grund auf neu erstellen.

  1. Erstellen Sie ein Projekt, und fügen Sie ein Element hinzu.
  2. Ändern Sie das Element wie gewünscht, z. B. fügen Sie hinzu, wo eine Parameterersetzung stattfinden soll, und speichern Sie das Element.
  3. Erstellen Sie eine XML-Datei, und speichern Sie sie mit der Dateierweiterung .vstemplate im selben Verzeichnis wie die Projektelementdatei.
  4. Fügen Sie der VSTEMPLATE-XML-Datei Metadaten für Elementvorlagen hinzu, wie im vorherigen Beispiel gezeigt. Weitere Informationen finden Sie unter Vorlagenschemareferenz (Erweiterbarkeit).
  5. Speichern und schließen Sie die VSTEMPLATE-Datei .
  6. Wählen Sie in Windows Explorer die Dateien aus, die Sie in die Vorlage aufnehmen möchten, einschließlich der VSTEMPLATE-Datei . Klicken Sie mit der rechten Maustaste auf die Auswahl und wählen Sie InZIP-Datei>.
  7. Kopieren Sie die resultierende .zipDatei, und fügen Sie sie am Speicherort der Visual Studio-Benutzerelementvorlage ein. Das Standardverzeichnis ist %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Verwandte Inhalte

  • Last updated on