Freigeben über

ProjectTemplateLink-Element (Visual Studio-Vorlagen)

  • Artikel

Gibt den Pfad zur VSTEMPLATE-Datei eines Projekts in einer Multiprojektvorlage an.

<VSTemplate TemplateContent><<>ProjectCollection><ProjectTemplateLink>

Oder

<VSTemplate TemplateContent>><<ProjectCollection ProjectFolder>><<ProjectTemplateLink>

Syntax

<ProjectTemplateLink ProjectName="Name">
    PathToTemplateFile
</ProjectTemplateLink>

Attribute und Elemente

In den folgenden Abschnitten werden attribute-Elemente sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut Beschreibung
ProjectName Optionales Attribut.

Gibt in einer Vorlage für mehrere Projekte den Namen für jedes einzelne Projekt an. Das Dialogfeld "Neues Projekt " kann einzelnen Projekten keine Namen zuweisen.
CopyParameters Ermöglicht, dass alle Variablen in der Hauptgruppenvorlage in jede der verknüpften Vorlagen kopiert werden können.

Die Parameter in verknüpften Vorlagen enthalten ein Präfix "$ext_*$". Wenn der Parameter beispielsweise in der übergeordneten Gruppenvorlage den Wert $projectname$ "ExampleProject1" aufweist, erhält die verknüpfte Vorlage die Ausführung der verknüpften Vorlage einen Parameter $ext_projectname$, bei dem es sich um eine Kopie des $projectname$ Parameters aus der übergeordneten Gruppenvorlage handelt.

Dadurch können verknüpfte Vorlagen einige häufig verwendete Parameter freigeben, die sonst möglicherweise nur in der Vorlage der übergeordneten Gruppe erstellt werden.

Dieses Attribut ist optional und erhält automatisch den Wert false, wenn es nicht enthalten ist.

Eingeführt in Visual Studio 2013 Update 2. Informationen zum Verweisen auf die richtige Produktversion finden Sie unter Referenzassemblys, die im Visual Studio 2013 SDK Update 2 bereitgestellt werden.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element Beschreibung
Projectcollection Legt die Organisation und den Inhalt von Vorlagen für mehrere Projekte fest.
Solutionfolder Gruppiert Projekte in Vorlagen für mehrere Projekte.

Text Wert

Ein Textwert ist erforderlich.

Dieser Text gibt den Pfad zur VSTEMPLATE-Datei der Vorlage an.

Hinweise

Vorlagen mit mehreren Projekten fungieren als Container für mindestens zwei Projekte. Das ProjectTemplateLink Element wird verwendet, um den Speicherort der VSTEMPLATE-Datei für eines der Projekte in der Vorlage anzugeben. Die VSTEMPLATE-Datei einer Multiprojektvorlage enthält ein ProjectTemplateLink Element für jedes Projekt in der Vorlage. Weitere Informationen zu Vorlagen mit mehreren Projekten finden Sie unter How to: Create multi-project templates.

Beispiel

Dieses Beispiel zeigt eine einfache Vstemplate-Stammdatei mit mehreren Projekten. In diesem Beispiel enthält die Vorlage zwei Projekte: My Windows Application und My Class Library. Das ProjectName Attribut für das ProjectTemplateLink Element legt den Namen für Visual Studio fest, um dieses Projekt zuzuweisen. Wenn das ProjectName Attribut nicht vorhanden ist, wird der Name der VSTEMPLATE-Datei als Projektname verwendet.

<VSTemplate Version="3.0.0" Type="ProjectGroup"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-Project Template Sample</Name>
        <Description>An example of a multi-project template</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectCollection>
            <ProjectTemplateLink ProjectName="My Windows Application">
                WindowsApp\MyTemplate.vstemplate
            </ProjectTemplateLink>
            <ProjectTemplateLink ProjectName="My Class Library" CopyParameters="true">
                ClassLib\MyTemplate.vstemplate
            </ProjectTemplateLink>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Weitere Informationen