Gewusst wie: Veröffentlichen von Projektvorlagen

Artikel
09/03/2008

Aktualisiert: November 2007

Damit eine Vorlage im Dialogfeld Neues Projekt angezeigt wird, muss sie auf dem Computer im richtigen Verzeichnis installiert werden. Zur Vereinfachung dieses Vorgangs können Sie die ZIP-Vorlagendatei in einer VSI (Visual Studio Installer)-Datei speichern und die Vorlage mit Visual Studio-Inhaltsinstaller am richtigen Speicherort ablegen. Durch Verwenden einer VSI-Datei können Sie die Vorlage (oder andere Komponenten für Visual Studio) auch für andere Entwickler freigeben.

VSI-Dateien

Bei einer VSI-Datei handelt es sich um eine ZIP-Datei mit einer umbenannten Dateinamenerweiterung. VSI-Dateien enthalten die folgenden Elemente:

Eine XML-Datei, in der der Inhalt beschrieben wird. Diese Datei muss die Dateinamenerweiterung .vscontent haben und einem bestimmten XML-Schema folgen. Eine vollständige Definition des XML-Schemas für .vscontent finden Sie unter Gewusst wie: Verpacken von Communitykomponenten, die den Visual Studio-Inhaltsinstaller verwenden.
Die Inhaltsdateien, z. B. eine ZIP-Vorlagendatei. Informationen zum Erstellen von ZIP-Vorlagendateien finden Sie unter Erstellen von Projekt- und Elementvorlagen.

Weitere Informationen zum Installieren von VSI-Dateien finden Sie unter Gewusst wie: Installieren von Communitykomponenten.

In der VSCONTENT-Datei müssen Sie bestimmte Werte und Attribute für die Vorlage festlegen, damit der Visual Studio-Inhaltsinstaller sie auf die richtige Weise und am richtigen Speicherort installiert. In der VSCONTENT-Datei müssen Sie bei einer Vorlage wie folgt vorgehen:

Legen Sie den Wert des FileContentType-Elements auf VSTemplate fest.
Fügen Sie ein Attribute-Element mit den folgenden Attributen hinzu:
- ProjectType-Attribut: Gibt den Eigenschaftentyp an, entweder Visual Basic, Visual C# oder Visual Web Developer.
- ProjectSubType-Attribut: Gibt die Unterkategorie an, in der die Vorlage im Dialogfeld Neues Projekt erscheinen soll.
- TemplateType-Attribut: Gibt den Vorlagentyp an, entweder Project oder Item.

So erstellen Sie eine VSI-Vorlagendatei

Erstellen Sie eine gültige VSCONTENT-Datei für den Inhalt. Weitere Informationen zum VSCONTENT-Dateischema finden Sie unter Gewusst wie: Verpacken von Communitykomponenten, die den Visual Studio-Inhaltsinstaller verwenden.
Wählen Sie die VSCONTENT-Datei und die anderen Dateien aus, die Sie in die VSI-Datei einschließen möchten. Klicken Sie mit der rechten Maustaste auf die Auswahl, klicken Sie auf Senden an, und klicken Sie dann auf ZIP-komprimierten Ordner. Die ausgewählten Dateien werden in eine ZIP-Datei komprimiert.

Ändern Sie die Dateinamenerweiterung der ZIP-Datei in .vsi.

Hinweis:
Wenn im Visual Studio-Inhaltsinstaller Herausgeberinformationen über Ihre Projektvorlage angezeigt werden sollen, müssen Sie die VSI-Datei signieren. Weitere Informationen erhalten Sie bei einem Anbieter von digitalen Zertifikaten.

Beispiel

Im folgenden Beispiel wird die VSCONTENT-Datei für eine VSI-Datei veranschaulicht, die eine Projektvorlage enthält. Die folgenden Dateien werden in die VSI-Datei für diesen Inhalt aufgenommen:

Eine VSCONTENT-Datei mit dem Code aus diesem Beispiel.
Eine Projektvorlage, MyProjectTemplate.zip.

In diesem Beispiel würde die Vorlage in der Visual Basic-Stammkategorie des Dialogfelds Neues Projekt installiert. Wenn Sie die Vorlage in einer Visual Basic-Unterkategorie installieren wollten, gäben Sie den Namen der Unterkategorie als Wert des ProjectSubType-Attributs an.

Hinweis:
Im folgenden Beispiel wird ein ContentVersion-Elementwert von 2.0 verwendet. Wenn eine Projektvorlage von Visual Studio 2005 oder von Visual Studio 2008 verwendet werden kann, geben Sie einen Wert von 1.0 an. Wenn eine Projektvorlage für Visual Studio 2008 spezifisch ist, geben Sie 2.0 an.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyProjectTemplate.zip</FileName>
        <DisplayName>Sample Project Template</DisplayName>
        <Description>A project template created for this example.</Description>
        <FileContentType>VSTemplate</FileContentType>
        <ContentVersion>2.0</ContentVersion>
        <Attributes>
            <Attribute name="ProjectType" value="Visual Basic"/>
            <Attribute name="ProjectSubType" value=""/>
            <Attribute name="TemplateType" value="Project"/>
        </Attributes>
    </Content>
</VSContent>

Siehe auch

Aufgaben

Gewusst wie: Verpacken von Communitykomponenten, die den Visual Studio-Inhaltsinstaller verwenden

Weitere Ressourcen

Erweiterte Verfahren für Vorlagen

Freigeben über