Элемент ProjectTemplateLink (шаблоны Visual Studio)

Статья
10/10/2023

Указывает путь к vstemplate-файлу одного проекта в шаблоне с несколькими проектами.

–или–

Синтаксис

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

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Description

ProjectName Необязательный атрибут элемента .

Задает имя каждого отдельного проекта в многопроектном шаблоне. Диалоговое окно "Новый проект" не может назначать имена отдельным проектам.

CopyParameters Включает копирование всех переменных в шаблоне основной группы в каждый из связанных шаблонов.

Параметры в связанных шаблонах имеют префикс "$ext_*$". Например, если в шаблоне родительской группы параметр $projectname$ имеет значение ExampleProject1, когда связанный шаблон получает свою очередь, он получает параметр, который является копией параметра $ext_projectname$ из родительского $projectname$ шаблона группы.

Это позволяет связанным шаблонам совместно использовать некоторые общие параметры, которые можно удобным образом создавать в шаблоне родительской группы.

Этот атрибут является необязательным и для него автоматически устанавливается значение по умолчанию false, если он не включен.

Представлено в обновлении 2 для Visual Studio 2013. Чтобы ссылаться на правильную версию продукта, см . статью "Справочные сборки", предоставляемые в пакете SDK для Visual Studio 2013 с обновлением 2.

Атрибут	Description
`ProjectName`	Необязательный атрибут элемента . Задает имя каждого отдельного проекта в многопроектном шаблоне. Диалоговое окно "Новый проект" не может назначать имена отдельным проектам.
`CopyParameters`	Включает копирование всех переменных в шаблоне основной группы в каждый из связанных шаблонов. Параметры в связанных шаблонах имеют префикс `"$ext_$"`. Например, если в шаблоне родительской группы параметр $projectname$ имеет значение ExampleProject1*, когда связанный шаблон получает свою очередь, он получает параметр, который является копией параметра $ext_projectname$ из родительского $projectname$ шаблона группы. Это позволяет связанным шаблонам совместно использовать некоторые общие параметры, которые можно удобным образом создавать в шаблоне родительской группы. Этот атрибут является необязательным и для него автоматически устанавливается значение по умолчанию `false`, если он не включен. Представлено в обновлении 2 для Visual Studio 2013. Чтобы ссылаться на правильную версию продукта, см . статью "Справочные сборки", предоставляемые в пакете SDK для Visual Studio 2013 с обновлением 2.

Дочерние элементы

Нет.

Родительские элементы

Элемент	Description
ProjectCollection	Указывает организацию и содержимое многопроектных шаблонов.
SolutionFolder	Группирует проекты в многопроектных шаблонах.

Текстовое значение

Текстовое значение является обязательным.

Этот текст указывает путь к vstemplate-файлу шаблона.

Замечания

Многопроектные шаблоны используются в качестве контейнера для двух или нескольких проектов. Элемент ProjectTemplateLink используется для указания расположения vstemplate-файла для одного из проектов в шаблоне. Vstemplate-файл шаблона с несколькими проектами содержит один ProjectTemplateLink элемент для каждого проекта в шаблоне. Дополнительные сведения о шаблонах с несколькими проектами см. в статье "Практическое руководство. Создание шаблонов с несколькими проектами".

Пример

В этом примере показан простой файл vstemplate с несколькими проектами . В этом примере шаблон содержит два проекта My Windows Application и My Class Library. Атрибут ProjectName элемента ProjectTemplateLink задает имя Visual Studio для назначения этого проекта. ProjectName Если атрибут не существует, имя vstemplate-файла используется в качестве имени проекта.

<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>

Share via