Freigeben über

Gewusst wie: Manuelles Erstellen von Projektvorlagen

  • Artikel

Visual Studio stellt Assistenten bereit, mit denen Sie Vorlagen von Projekten generieren können, die in der integrierten Entwicklungsumgebung (IDE) geöffnet sind. Wenn Sie jedoch außerhalb der Entwicklungsumgebung eine Vorlage erstellen möchten, können Sie die folgenden Schritte ausführen, um die Quelldateien Ihrer Anwendung manuell in eine Visual Studio-Projektvorlage aufzunehmen.

Das Erstellen einer benutzerdefinierten Projektvorlage umfasst neben dem Entwerfen und Entwickeln des Projekts auch die Bereitstellung von Metadaten zur Projektvorlage.

Benutzerdefinierte Projektvorlagen erfordern folgende Elemente:

  • Eine Metadatendatei (.vstemplate), über die Visual Studio definiert, wie das Projektelement in der Entwicklungsumgebung angezeigt wird und – falls entsprechende Eigenschaften festgelegt wurden – wie die Erstellung des Projekts in der Entwicklungsumgebung angepasst wird.

  • Eine Projektdatei.

  • Codedateien wie Windows Forms, Web Forms, Klassendateien und Ressourcendateien.

Alle Elemente werden in einer ZIP-Datei komprimiert. Die ZIP-Datei muss an einem Ort gespeichert werden, an dem Visual Studio nach benutzerdefinierten Projektvorlagen sucht. Benutzerdefinierte Projektvorlagen werden in den Ordnern der einzelnen Programmiersprachen im Dialogfeld Neues Projekt im Bereich Meine Vorlagen aufgelistet. Weitere Informationen finden Sie unter Gewusst wie: Suchen und Organisieren von Projekt- und Elementvorlagen.

So erstellen Sie eine Vorlage manuell

  1. Erstellen Sie ein Projekt.

  2. Bearbeiten Sie die Codedateien, um anzugeben, an welcher Stelle Parameterersetzungen stattfinden sollen. Weitere Informationen zur Ersetzung von Parametern finden Sie unter Gewusst wie: Ersetzen von Parametern in einer Vorlage.

  3. Erstellen Sie eine XML-Datei, und speichern Sie diese als "MyTemplate.vstemplate" im selben Verzeichnis wie das Projekt. Die Datei sollte dem Projekt in Visual Studio jedoch nicht hinzugefügt werden.

  4. Bearbeiten Sie die Datei "MyTemplate.vstemplate", um Metadaten für die Projektvorlage bereitzustellen. Weitere Informationen finden Sie im Beispiel im folgenden Abschnitt.

  5. Wählen Sie die in der Vorlage enthaltenen Dateien (einschließlich der VSTEMPLATE-Datei) aus, und klicken Sie mit der rechten Maustaste darauf. Klicken Sie anschließend auf Senden an und ZIP-komprimierten Ordner. Die zuvor extrahierten Dateien werden in einer ZIP-Datei komprimiert.

  6. Legen Sie die ZIP-Datei der Vorlage im Projektvorlagenverzeichnis von Visual Studio ab. Dieses Verzeichnis befindet sich unter dem Visual Studio-Installationsverzeichnis und hat den Namen "Templates\ProjectTemplates\".

Beispiel

In diesem Beispiel wird eine einfache VSTEMPLATE-Metadatendatei veranschaulicht. Durch das TemplateData-Element werden Projekttyp, Name, Beschreibung und Symbol angegeben, die im Dialogfeld Neues Projekt angezeigt werden. Durch das TemplateContent-Element werden der Name der Projektdatei sowie die im Projekt enthaltenen Dateien angegeben. In diesem Beispiel hat die Projektdatei den Namen MyTemplate.csproj. Sie enthält die Dateien, die ein Visual C#-Projekt normalerweise enthält.

<VSTemplate Version="3.0.0" xmlns="https://schemas.microsoft.com/developer/vstemplate/2005" Type="Project">
  <TemplateData>
    <Name>My template</Name>
    <Description>Basic C# application</Description>
    <ProjectType>CSharp</ProjectType>
    <ProjectSubType>
    </ProjectSubType>
    <SortOrder>1000</SortOrder>
    <CreateNewFolder>true</CreateNewFolder>
    <DefaultName>Simple</DefaultName>
    <ProvideDefaultName>true</ProvideDefaultName>
    <LocationField>Enabled</LocationField>
    <EnableLocationBrowseButton>true</EnableLocationBrowseButton>
    <Icon>__TemplateIcon.ico</Icon>
  </TemplateData>
  <TemplateContent>
    <Project TargetFileName="MyTemplate.csproj" File="Killer.csproj" ReplaceParameters="true">
      <ProjectItem ReplaceParameters="true" TargetFileName="App.config">App.config</ProjectItem>
      <ProjectItem ReplaceParameters="true" TargetFileName="Form1.cs">Form1.cs</ProjectItem>
      <ProjectItem ReplaceParameters="true" TargetFileName="Form1.Designer.cs">Form1.Designer.cs</ProjectItem>
      <ProjectItem ReplaceParameters="true" TargetFileName="Program.cs">Program.cs</ProjectItem>
      <Folder Name="Properties" TargetFolderName="Properties">
        <ProjectItem ReplaceParameters="true" TargetFileName="AssemblyInfo.cs">AssemblyInfo.cs</ProjectItem>
        <ProjectItem ReplaceParameters="true" TargetFileName="Resources.resx">Resources.resx</ProjectItem>
        <ProjectItem ReplaceParameters="true" TargetFileName="Resources.Designer.cs">Resources.Designer.cs</ProjectItem>
        <ProjectItem ReplaceParameters="true" TargetFileName="Settings.settings">Settings.settings</ProjectItem>
        <ProjectItem ReplaceParameters="true" TargetFileName="Settings.Designer.cs">Settings.Designer.cs</ProjectItem>
      </Folder>
    </Project>
  </TemplateContent>
</VSTemplate>

Siehe auch

Aufgaben

Gewusst wie: Manuelles Erstellen von Webvorlagen

Gewusst wie: Erstellen von Projektvorlagen

Gewusst wie: Ersetzen von Parametern in einer Vorlage

Referenz

Schemareferenz zu Visual Studio-Vorlagen

Weitere Ressourcen

Starter Kits

Visual Studio-Vorlagen

Export Template Wizard