Практическое руководство. Создание многофайловых шаблонов элементов

Статья
02/20/2013

Шаблоны элементов могут определять только один элемент, но иногда элемент состоит из нескольких файлов.Например, шаблон элемента Windows Forms в Visual Basic 3 требует следующих файлов:

VB-файла, содержащего код формы.
DESIGNER.VB-файла, содержащего сведения конструктора для формы.
RESX-файла, содержащего внедренные ресурсы для формы.

Многофайловые шаблоны элементов требуют использования параметров для обеспечения правильности используемых расширений имен файлов при создании элемента в Visual Studio.При создании шаблона элемента с помощью мастера Экспорт шаблона эти параметры создаются автоматически и дальнейшее редактирование не требуется.В следующей процедуре описаны способы использования параметров для обеспечения правильных создаваемых расширений имен файлов.

Чтобы вручную создать многофайловый шаблон элемента

Создайте шаблон элемента таким же образом, как и шаблон элемента из одного файла.Дополнительные сведения см. в разделе Практическое руководство. Создание шаблонов элементов.
Добавьте атрибуты TargetFileName к каждому элементу ProjectItem.Установите значение атрибутов TargetFileName на $fileinputname$.расширение_файла, где расширение_файла — это расширение имени файла, включенного в шаблон.Примеры.
```
<ProjectItem TargetFileName="$fileinputname$.vb">
    Form1.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.Designer.vb">
    Form1.Designer.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.resx">
    Form1.resx
</ProjectItem>
```
Когда элемент, производный от этого шаблона, добавляется в проект, имена файлов будут основываться на имени, введенном пользователем в диалоговом окне Добавление нового элемента.
Выберите файлы для включения в шаблон, щелкните их правой кнопкой мыши, выберите Отправить, затем щелкните Сжатая ZIP-папка.Выбранные файлы будут сжаты в ZIP-файл.
Поместите ZIP-файл в расположение с пользовательскими шаблонами элементов.По умолчанию каталог \Мои документы\Visual Studio номер версии\Templates\ItemTemplates\.Дополнительные сведения см. в разделе Практическое руководство. Размещение и упорядочение шаблонов проектов и элементов.

Пример

В следующем примере показан шаблон Windows Forms в Visual Studio.При создании элемента, основанного на этом шаблоне, имена трех созданных файлов будут соответствовать имени, введенному в диалоговом окне Добавление нового элемента.

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

См. также

Задачи

Практическое руководство. Создание шаблонов элементов

Практическое руководство. Замена параметров в шаблоне

Основные понятия

Знакомство с шаблонами Visual Studio

Параметры шаблона

Поделиться через