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


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

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

  • VB-файла, содержащего код формы.

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

  • RESX-файла, содержащего внедренные ресурсы для формы.

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

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

  1. Создайте шаблон элемента таким же образом, как и шаблон элемента из одного файла. Дополнительные сведения см. в разделе Практическое руководство. Создание шаблонов элементов вручную.

  2. Добавьте атрибуты 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>
    

    Когда элемент, производный от этого шаблона, добавляется в проект, имена файлов будут основываться на имени, введенном пользователем в диалоговом окне Добавление нового элемента.

  3. Выберите файлы для включения в шаблон, щелкните их правой кнопкой мыши, выберите Отправить, затем щелкните Сжатая ZIP-папка. Выбранные файлы будут сжаты в ZIP-файл.

  4. Поместите ZIP-файл в расположение с пользовательскими шаблонами элементов. По умолчанию это каталог \My Documents\Visual Studio 2010\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>

См. также

Задачи

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

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

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

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

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

Другие ресурсы

Создание шаблонов элементов