Udostępnij za pośrednictwem

Tworzenie szablonów elementów obejmujących wiele plików

  • Artykuł

Szablony elementów mogą określać tylko jeden element, ale czasami element składa się z wielu plików. Na przykład szablon elementu Formularze systemu Windows wymaga następujących trzech plików:

  • Plik zawierający kod formularza

  • Plik zawierający informacje o projektancie formularza

  • Plik zawierający osadzone zasoby formularza

Szablony elementów z wieloma plikami wymagają parametrów, aby upewnić się, że podczas tworzenia elementu są używane poprawne rozszerzenia plików. Jeśli tworzysz szablon elementu z wieloma plikami przy użyciu Kreatora eksportu szablonu, te parametry są generowane automatycznie i nie są wymagane żadne dalsze edycje.

Korzystanie z Kreatora eksportowania szablonu

Szablon elementu z wieloma plikami można utworzyć w taki sam sposób, jak w przypadku szablonu elementu pojedynczego pliku. Zobacz Instrukcje: tworzenie szablonów elementów. Na stronie Wybieranie elementu do wyeksportowania kreatora wybierz plik, który ma pliki zależne (na przykład plik formularza formularzy systemu Windows). Kreator automatycznie dołącza wszystkie pliki zależne, takie jak projektant i pliki zasobów, w szablonie.

Ręczne tworzenie szablonu elementu z wieloma plikami

  1. Utwórz szablon elementu w taki sposób, aby ręcznie utworzyć szablon elementu pojedynczego pliku, ale uwzględnij każdy plik, który stanowi element z wieloma plikami.

  2. W pliku XML .vstemplate dodaj ProjectItem element dla każdego pojedynczego pliku i dodaj TargetFileName atrybut do tego elementu. Ustaw wartość atrybutu TargetFileName na $fileinputname$. FileExtension, gdzie FileExtension to rozszerzenie pliku, które jest zawarte w szablonie. Na przykład:

    <ProjectItem TargetFileName="$fileinputname$.vb">
    Form1.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.Designer.vb">
    Form1.Designer.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.resx">
    Form1.resx
</ProjectItem>

    Uwaga

    Po dodaniu elementu pochodzącego z tego szablonu do projektu nazwy plików będą pochodzić od nazwy wprowadzonej przez użytkownika w oknie dialogowym Dodawanie nowego elementu .

  3. Wybierz pliki, które mają zostać uwzględnione w szablonie, kliknij prawym przyciskiem myszy zaznaczenie, a następnie wybierz pozycję Wyślij do>folderu Skompresowane (zipped).

    Wybrane pliki są kompresowane do pliku zip .

  4. Skopiuj plik zip do lokalizacji szablonu elementu użytkownika. Domyślnie katalog to %USERPROFILE%\Documents\Visual Studio <Version>\Templates\ItemTemplates. Aby uzyskać więcej informacji, zobacz Instrukcje: lokalizowanie i organizowanie szablonów.

  5. Zamknij program Visual Studio, a następnie otwórz go ponownie.

  6. Utwórz nowy projekt lub otwórz istniejący projekt, a następnie wybierz pozycję Project Add New Item (Dodaj nowy element)>lub naciśnij klawisze Ctrl+Shift+A.

    Szablon elementu z wieloma plikami zostanie wyświetlony w oknie dialogowym Dodawanie nowego elementu .

Przykład

W poniższym przykładzie przedstawiono szablon formularzy systemu Windows. Po utworzeniu elementu na podstawie tego szablonu nazwy trzech utworzonych plików będą zgodne z nazwą wprowadzoną w oknie dialogowym Dodawanie nowego elementu .

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

Powiązana zawartość