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

Создание многофайловых шаблонов элементов

  • Статья

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

  • файл, содержащий код для формы;

  • файл, содержащий сведения конструктора для формы;

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

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

Использование мастера экспорта шаблонов

Многофайловый шаблон элемента создается аналогично однофайловому шаблону элемента. См. раздел Практическое руководство. Создание шаблонов элементов. На странице Выбор элементов для экспорта мастера выберите файл, который содержит зависимые файлы (например, файл формы Windows Forms). Мастер автоматически включит в шаблон все зависимые файлы, например файлы ресурсов и конструктора.

Создание шаблона многофайлового элемента вручную

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

  2. В VSTEMPLATE-файл XML-кода добавьте элемент ProjectItem для каждого отдельного файла и добавьте атрибут TargetFileName в этот элемент. Присвойте атрибуту TargetFileName значение $входное_имя_файла$.расширение_файла, где расширение_файла — это расширение файла, включаемого в шаблон. Рассмотрим пример.

    <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-файл в расположение, где находится пользовательский шаблон элемента. По умолчанию это каталог %USERPROFILE%\Documents\Visual Studio <версия>\Templates\ItemTemplates. Дополнительные сведения см. в статье Практическое руководство. Размещение и упорядочение шаблонов и элементов.

  5. Закройте Visual Studio, а затем откройте среду повторно.

  6. Создайте новый проект или откройте существующий, а затем выберите Проект>Добавить новый элемент или нажмите клавиши CTRL+SHIFT+A.

    Многофайловый шаблон элемента появится в диалоговом окне Добавление нового элемента.

Пример

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

<VSTemplate Version="2.0.0" Type="Item"
    xmlns="http://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>

Связанный контент