Udostępnij przez

Tworzenie szablonów elementów

W tym artykule pokazano, jak utworzyć szablon elementu za pomocą Kreatora eksportu szablonu lub ręcznie, a także jak edytować i używać szablonów elementów. Jeśli szablon składa się z wielu plików, zobacz również Porady: tworzenie szablonów elementów z wieloma plikami.

Dodawanie szablonu elementu

  1. Tworzenie lub otwieranie projektu w programie Visual Studio.

  2. Wybierz pozycję Dodaj>nowy element projektu lub naciśnij Ctrl+Shift+A.

  3. W oknie dialogowym Dodawanie nowego elementu wybierz element, a następnie wybierz pozycję Dodaj , aby dodać go do projektu.

  4. Zmodyfikuj element zgodnie z potrzebami i wskaż, w którym miejscu, jeśli gdziekolwiek, powinna nastąpić zamiana parametrów. Aby uzyskać więcej informacji, zobacz How to: Substitute parameters in a template (Instrukcje: zastępowanie parametrów w szablonie).

  5. Zapisz element.

  6. Wybierzopcję Szablon eksportuprojektu>. Otwiera się Kreator Eksportu Szablonu.

  7. Na stronie Wybierz typ szablonu wybierz pozycję Szablon elementu, wybierz projekt zawierający element, a następnie wybierz przycisk Dalej.

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

  9. Na stronie Wybierz odwołania do elementu wybierz wszystkie odwołania do zestawu, które mają zostać uwzględnione w szablonie, a następnie wybierz przycisk Dalej.

  10. Na stronie Wybieranie opcji szablonu :

    • Wprowadź nazwę szablonu i opcjonalny opis, obraz ikony i obraz podglądu.

      Pliki ikon dla elementów są .ico plikami, zgodnie z opisem w temacie Obrazy i ikony dla programu Visual Studio. Obraz podglądu to obraz o wymiarach 200 x 200, który pojawia się w oknie dialogowym Dodawanie nowego elementu . Możesz pobrać bibliotekę obrazów programu Visual Studio , aby uzyskać ikony spójne ze stylem programu Visual Studio.

    • Wybierz, czy chcesz automatycznie zaimportować szablon do programu Visual Studio i wyświetlić okno eksploratora w folderze plików wyjściowych.

  11. Wybierz Zakończ

Pliki szablonów są kompresowane do pliku .zip i kopiowane do katalogu wyświetlanego w kreatorze w obszarze Lokalizacja wyjściowa. Domyślna lokalizacja to %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

W przypadku wybrania opcji Automatycznie importuj szablon do programu Visual Studio plik .zip zostanie również dodany do katalogu ItemTemplates użytkownika. Lokalizacja domyślna to %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Teraz możesz używać szablonu elementu w swoich projektach.

Korzystanie z szablonu elementu

  1. Jeśli podczas tworzenia szablonu nie wybrano opcji Automatycznie importuj szablon do programu Visual Studio , skopiuj plik .zip do katalogu ItemTemplates . Lokalizacja domyślna to %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Zamknij program Visual Studio, a następnie otwórz go ponownie.
  3. Utwórz nowy projekt lub otwórz istniejący projekt, a następnie wybierz pozycję Projekt>Dodaj nowy element
  4. Wybierz szablon elementu w oknie dialogowym Dodawanie nowego elementu . Jeśli opis został dodany w Kreatorze eksportu szablonu, opis jest wyświetlany po prawej stronie okna dialogowego.
  5. Wybierz pozycję Dodaj , aby dodać element szablonu do projektu.

Edytowanie pliku vstemplate

Kreator tworzy szablon podstawowy, ale w niektórych przypadkach po wyeksportowaniu szablonu trzeba ręcznie zmodyfikować plik vstemplate . Jeśli na przykład chcesz, aby element pojawił się w oknie dialogowym Dodawanie nowego elementu dla projektu aplikacji uniwersalnej systemu Windows, musisz edytować plik vstemplate .

  1. Wyodrębnij plik .zip wyeksportowanego szablonu elementu i otwórz plik vstemplate w programie Visual Studio.
  2. Edytuj plik zgodnie z potrzebami. W przypadku projektu uniwersalnego systemu Windows w języku C# dodaj <TemplateID>Microsoft.CSharp.Class</TemplateID> wewnątrz <TemplateData> elementu.
  3. Zapisz i zamknij plik vstemplate , a następnie zastąp go w pliku .zip .

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

Możesz edytować plik vstemplate , aby określić, że szablon elementu jest wyświetlany tylko dla niektórych podtypów projektu, takich jak Windows, Office, Baza danych lub Sieć Web.

  1. Otwórz plik vstemplate do edycji.
  2. Dodaj element ProjectSubType bezpośrednio po ProjectType elemencie z wartością Windows, Office, Database, lub Web. Na przykład: <ProjectSubType>Database</ProjectSubType>.

W poniższym przykładzie przedstawiono plik vstemplate dla Office projektów.

<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

Zamiast korzystać z kreatora, możesz ręcznie utworzyć szablon elementu od podstaw.

  1. Utwórz projekt i dodaj element.
  2. Zmodyfikuj element zgodnie z potrzebami, na przykład dodając miejsce, w którym powinna nastąpić zamiana dowolnego parametru, i zapisz element.
  3. Utwórz plik XML i zapisz go z rozszerzeniem pliku vstemplate w tym samym katalogu, w którym znajduje się plik elementu projektu.
  4. Dodaj metadane szablonu elementu do pliku XML vstemplate , jak pokazano w poprzednim przykładzie. Aby uzyskać więcej informacji, zobacz Dokumentacja schematu szablonu (rozszerzalność).
  5. Zapisz i zamknij plik vstemplate .
  6. W Eksploratorze Windows wybierz pliki, które chcesz dołączyć do szablonu, w tym plik vstemplate . Kliknij prawym przyciskiem myszy zaznaczenie i wybierz Kompresuj do>Plik ZIP.
  7. Skopiuj wynikowy plik .zip i wklej go w lokalizacji szablonu elementu użytkownika programu Visual Studio. Katalog domyślny to %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Powiązana zawartość

  • Last updated on