Gewusst wie: Hinzufügen von Verweisen zu Vorlagen

Artikel
08/10/2011

Verwenden Sie diese Verfahren zum Erstellen von Vorlagen, die Verweise auf Assemblys enthalten.

Hinzufügen von Verweisen in Projektvorlagen

Projektvorlagen enthalten immer eine Projektdatei, über die Verweise in der Vorlage hinzugefügt oder entfernt werden können.

So fügen Sie Verweise in Projektvorlagen hinzu

Klicken Sie im Menü Datei erst auf Neu und dann auf Projekt.
Wählen Sie im Dialogfeld Neues Projekt die zu aktualisierende Vorlage aus, geben Sie einen Namen und Speicherort für das Projekt ein, und klicken Sie auf OK.
Fügen Sie dem Projekt über das Dialogfeld Verweis hinzufügen Verweise hinzu, oder entfernen Sie Verweise. Weitere Informationen zum Hinzufügen von Verweisen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Verweisen in Visual Studio.
Verwenden Sie den Assistenten Vorlage exportieren, um eine neue Vorlage zu erstellen. Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Starter Kits.
Nachdem die aktualisierte Vorlage in einer ZIP-Datei komprimiert wurde, löschen Sie die alte ZIP-Datei der Vorlage.

Hinzufügen von Verweisen in Elementvorlagen

Elementvorlagen enthalten keine Projektdateien. Aus diesem Grund unterscheidet sich das Hinzufügen von Verweisen zu Elementvorlagen vom Hinzufügen von Verweisen zu Projektvorlagen. Verweise können Elementvorlagen über den Assistenten Vorlage exportieren oder manuell durch Bearbeiten der VSTEMPLATE-Datei in der Vorlage hinzugefügt werden.

Tipp

Damit die Vorlage ordnungsgemäß funktioniert, müssen auf jedem Computer, der diese Vorlage verwendet, alle Assemblys installiert sein, auf die verwiesen wird. Falls die Möglichkeit besteht, dass die Assemblys auf einigen Computern nicht installiert sind, geben Sie die Assemblys am selben Speicherort frei, an dem Sie die Vorlage freigeben, und lassen Sie die Assemblys von allen Benutzern auf deren Computern installieren. Informationen zum Installieren von Assemblys finden Sie unter Gewusst wie: Installieren einer Assembly in den globalen Assemblycache.

So verwenden Sie den Assistenten Vorlage exportieren, um Verweise in Elementvorlagen hinzuzufügen

Erstellen oder öffnen Sie ein Projekt in Visual Studio.
Fügen Sie dem Projekt ein Element hinzu, und ändern Sie es, falls erforderlich.
Klicken Sie im Menü Datei auf Vorlage exportieren.
Klicken Sie auf Elementvorlage, wählen Sie das Projekt aus, das das Element enthält, und klicken Sie auf Weiter.
Wählen Sie das Element aus, für das eine Vorlage erstellt werden soll, und klicken Sie auf Weiter.
Wählen Sie die Assemblyverweise aus, die in die Vorlage eingeschlossen werden sollen, und klicken Sie auf Weiter.

Tipp

Die Liste von Assemblys wird im aktuellen Projekt aus den Assemblyverweisen generiert. Wenn die Assembly, auf die Sie verweisen möchten, nicht in der Liste enthalten ist, beenden Sie den Assistenten, fügen Ihrem Projekt den Verweis hinzu und führen den Assistenten erneut aus.
Geben Sie den Symboldateinamen, Vorlagennamen und die Vorlagenbeschreibung ein, und klicken Sie auf Fertig stellen.
Wenn Sie eine vorhandene Vorlage geändert haben, löschen Sie die alte ZIP-Datei der Vorlage.

Alternativ können Sie die Datei VSTEMPLATE-Datei manuell bearbeiten, um der Elementvorlage Verweise hinzuzufügen.

So fügen Sie manuell Verweise in Elementvorlagen hinzu

Suchen Sie die ZIP-Datei, die die Vorlage enthält.
Extrahieren Sie die ZIP-Datei.
Öffnen Sie die VSTEMPLATE-Datei in Visual Studio.
Fügen Sie im TemplateContent-Element ein References-Element hinzu.
Fügen Sie im References-Element mindestens ein Reference-Element hinzu, das die zu referenzierenden Assemblys enthält.

Fügen Sie in jedem Reference-Element ein Assembly-Element mit der zu referenzierenden Assembly hinzu. Beispiel:

<TemplateContent>
    <References>
        <Reference>
            <Assembly>
                System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
        <Reference>
            <Assembly>
                System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
    </References>
    ...
</TemplateContent>

Tipp

Auf Assemblys muss über deren starken Namen verwiesen werden.

Speichern und schließen Sie die VSTEMPLATE-Datei.
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.
Löschen Sie die extrahierten Vorlagendateien und die alte ZIP-Datei der Vorlage.
Fügen Sie die neue ZIP-Datei in dasselbe Verzeichnis ein, in dem sich die gelöschte ZIP-Datei befand.