Gewusst wie: Erstellen von Elementvorlagen mit mehreren Dateien

  • Artikel

Aktualisiert: November 2007

Durch Elementvorlagen wird möglicherweise nur ein Element angegeben, manchmal besteht das Element jedoch aus mehreren Dateien. Elementvorlagen für Windows Forms erfordern beispielsweise die folgenden drei Dateien:

  • Eine VB-Datei, die den Code für das Formular enthält.

  • Eine DESIGNER.VB-Datei, die Designerinformationen zum Formular enthält.

  • Eine RESX-Datei, die die eingebetteten Ressourcen für das Formular enthält.

Elementvorlagen mit mehreren Dateien erfordern die Verwendung von Parametern, um sicherzustellen, dass beim Erstellen des Elements in Visual Studio die richtigen Dateierweiterungen verwendet werden. Wenn Sie eine Elementvorlage mit dem Assistenten Vorlage exportieren erstellen, werden diese Parameter automatisch generiert, und es ist keine weitere Bearbeitung erforderlich. Im folgenden Verfahren wird erläutert, wie Sie anhand von Parametern sicherstellen, dass die richtigen Dateierweiterungen erstellt werden.

So erstellen Sie eine Elementvorlage mit mehreren Dateien manuell

  1. Erstellen Sie die Elementvorlage auf die gleiche Weise, wie Sie eine Elementvorlage für eine einzelne Datei erstellen. Weitere Informationen finden Sie unter Gewusst wie: Manuelles Erstellen von Elementvorlagen.

  2. Fügen Sie jedem ProjectItem-Element TargetFileName-Attribute hinzu. Legen Sie den Wert des TargetFileName-Attributs auf $fileinputname$.FileExtension fest, wobei FileExtension der Dateierweiterung der Datei entspricht, die in die Vorlage aufgenommen wird. Beispiel:

    <ProjectItem TargetFileName="$fileinputname$.vb">
    Form1.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.Designer.vb">
    Form1.Designer.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.resx">
    Form1.resx
</ProjectItem>

    Wenn ein von dieser Vorlage abgeleitetes Element einem Projekt hinzugefügt wird, basieren die Dateinamen auf dem Namen, den der Benutzer im Dialogfeld Neues Element hinzufügen eingegeben hat.

  3. Wählen Sie die in die Vorlage eingeschlossenen Dateien aus, und klicken Sie mit der rechten Maustaste. Wählen Sie Senden an, und klicken Sie auf ZIP-komprimierter Ordner. Die ausgewählten Dateien werden in einer ZIP-Datei komprimiert.

  4. Legen Sie die ZIP-Datei am Speicherort der Benutzerelementvorlage ab. Dieses Verzeichnis lautet standardmäßig \Eigene Dateien\Visual Studio 2008\Templates\ItemTemplates\. Weitere Informationen finden Sie unter Gewusst wie: Suchen und Organisieren von Projekt- und Elementvorlagen.

Beispiel

Im folgenden Beispiel wird eine Windows Form-Vorlage in Visual Studio dargestellt. Wenn ein Element auf der Grundlage dieser Vorlage erstellt wird, entspricht der Name der drei erstellten Dateien dem im Dialogfeld Neues Element hinzufügen eingegebenen Namen.

<VSTemplate Version="2.0.0" Type="Item"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-file Item Template</Name>
        <Icon>Icon.ico</Icon>
        <Description>An example of a multi-file item template</Description>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectItem TargetFileName="$fileinputname$.vb" SubType="Form">
            Form1.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.Designer.vb">
            Form1.Designer.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.resx">
            Form1.resx
        </ProjectItem>
    </TemplateContent>
</VSTemplate>

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Elementvorlagen

Gewusst wie: Manuelles Erstellen von Elementvorlagen

Gewusst wie: Ersetzen von Parametern in einer Vorlage

Konzepte

Vorlagenparameter

Weitere Ressourcen

Erstellen von Elementvorlagen