Udostępnij za pośrednictwem

Tworzenie szablonów elementów

  • Artykuł

W tym artykule pokazano, jak utworzyć szablon elementu przy użyciu Kreatora eksportu szablonu. Jeśli szablon będzie składać się z wielu plików, zobacz Instrukcje: tworzenie szablonów elementów z wieloma plikami.

Dodawanie szablonu elementu do okna dialogowego Dodawanie nowego elementu

  1. Tworzenie lub otwieranie projektu w programie Visual Studio.

  2. Dodaj element do projektu i zmodyfikuj go, jeśli chcesz.

  3. Zmodyfikuj plik kodu, aby wskazać miejsce zastąpienia parametrów. Aby uzyskać więcej informacji, zobacz How to: Substitute parameters in a template (Instrukcje: zastępowanie parametrów w szablonie).

  4. W menu Projekt wybierz pozycję Eksportuj szablon.

  5. Na stronie Wybieranie typu szablonu wybierz pozycję Szablon elementu, wybierz projekt zawierający element, a następnie wybierz przycisk Dalej.

  6. Na stronie Wybieranie elementu do wyeksportowania wybierz element, dla którego chcesz utworzyć szablon, a następnie wybierz przycisk Dalej.

  7. Na stronie Wybieranie odwołań do elementów wybierz odwołania do zestawów do uwzględnienia w szablonie, a następnie wybierz przycisk Dalej.

  8. Na stronie Wybieranie opcji szablonu wprowadź nazwę szablonu i opcjonalny opis, obraz ikony i obraz podglądu, a następnie wybierz pozycję Zakończ. Pliki ikon dla elementów to .ico pliki, zgodnie z opisem w temacie Obrazy i ikony programu Visual Studio — typy plików. Obraz podglądu to obraz 200 x 200, który zostanie wyświetlony w oknie dialogowym Dodawanie nowego elementu .

    Możesz wyszukać w bibliotece obrazów programu Visual Studio ikony zgodne ze stylem programu Visual Studio.

    Pliki szablonu są dodawane do pliku .zip i kopiowane do katalogu określonego w kreatorze. Domyślną lokalizacją jest %USERPROFILE%\Documents\Visual Studio <version>\My Wyeksportowane szablony.

  9. Jeśli nie wybrano opcji Automatycznie zaimportuj szablon do programu Visual Studio w Kreatorze eksportu szablonu, znajdź wyeksportowany szablon. Następnie skopiuj go do katalogu szablonu elementu użytkownika. Domyślną lokalizacją jest %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

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

  11. 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 zostanie wyświetlony w oknie dialogowym Dodawanie nowego elementu . Jeśli dodano opis w Kreatorze eksportu szablonu, opis zostanie wyświetlony po prawej stronie okna dialogowego.

Włączanie szablonu elementu do użycia w projekcie aplikacji uniwersalnej systemu Windows

Kreator wykonuje większość pracy nad utworzeniem szablonu podstawowego, ale w wielu przypadkach należy ręcznie zmodyfikować plik vstemplate po wyeksportowaniu szablonu. Jeśli na przykład chcesz, aby element był wyświetlany w oknie dialogowym Dodawanie nowego elementu dla projektu Aplikacja uniwersalna systemu Windows, musisz wykonać kilka dodatkowych kroków.

  1. Wykonaj kroki opisane w poprzedniej sekcji, aby wyeksportować szablon elementu.

  2. Wyodrębnij utworzony plik .zip i otwórz plik vstemplate w programie Visual Studio.

  3. W przypadku projektu uniwersalnego systemu Windows w języku C# dodaj następujący kod XML wewnątrz <TemplateData> elementu:

    <TemplateID>Microsoft.CSharp.Class</TemplateID>

  4. W programie Visual Studio zapisz plik vstemplate i zamknij go.

  5. Skopiuj i wklej plik vstemplate z powrotem do pliku .zip .

    Jeśli zostanie wyświetlone okno dialogowe Kopiowanie pliku, wybierz opcję Kopiuj i Zamień.

Teraz możesz dodać element na podstawie tego szablonu do projektu uniwersalnego systemu Windows w oknie dialogowym Dodawanie nowego elementu .

Włączanie szablonów dla określonych podtypów projektu

Możesz określić, że szablon powinien być wyświetlany tylko dla niektórych podtypów projektu, takich jak Windows, Office, Database lub Web.

  1. ProjectType Znajdź element w pliku vstemplate szablonu elementu.

  2. Dodaj element ProjectSubType bezpośrednio po elemecie ProjectType .

  3. Ustaw wartość tekstowa elementu na jedną z następujących wartości:

    • Windows
    • Office
    • baza danych
    • Internet

Na przykład: <ProjectSubType>Database</ProjectSubType>.

W poniższym przykładzie przedstawiono szablon elementu dla projektów pakietu Office .

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

Ręczne tworzenie szablonu elementu

W niektórych przypadkach możesz ręcznie utworzyć szablon elementu od podstaw.

  1. Utwórz projekt i element projektu.

  2. Zmodyfikuj element projektu, dopóki nie będzie gotowy do zapisania jako szablonu.

  3. Zmodyfikuj plik kodu, aby wskazać miejsce zastąpienia parametru, jeśli w dowolnym miejscu. Aby uzyskać więcej informacji na temat zastępowania parametrów, zobacz How to: Substitute parameters in a template (Instrukcje: zastępowanie parametrów w szablonie).

  4. Utwórz plik XML i zapisz go przy użyciu rozszerzenia .vstemplate w tym samym katalogu co plik elementu projektu.

  5. Edytuj plik XML vstemplate, aby udostępnić metadane szablonu elementu. Aby uzyskać więcej informacji, zobacz Dokumentacja schematu szablonu (rozszerzalność) i przykład w poprzedniej sekcji.

  6. Zapisz plik vstemplate i zamknij go.

  7. W Eksploratorze Windows wybierz pliki, które chcesz uwzględnić w szablonie. Kliknij prawym przyciskiem myszy zaznaczenie, a następnie wybierz polecenie Wyślij do>folderu Skompresowane (zipped). Wybrane pliki są kompresowane do pliku .zip .

  8. Skopiuj plik .zip i wklej go w lokalizacji szablonu elementu użytkownika. Domyślny katalog to %USERPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates. Aby uzyskać więcej informacji, zobacz How to: Locate and organize project and item templates (Instrukcje: lokalizowanie i organizowanie szablonów projektów i elementów).

Powiązana zawartość