Tworzenie szablonów elementów
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
Tworzenie lub otwieranie projektu w programie Visual Studio.
Dodaj element do projektu i zmodyfikuj go, jeśli chcesz.
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).
W menu Projekt wybierz pozycję Eksportuj szablon.
Na stronie Wybieranie typu szablonu wybierz pozycję Szablon elementu, wybierz projekt zawierający element, a następnie wybierz przycisk Dalej.
Na stronie Wybieranie elementu do wyeksportowania wybierz element, dla którego chcesz utworzyć szablon, a następnie wybierz przycisk Dalej.
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.
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
.icopliki, 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.
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.
Zamknij program Visual Studio, a następnie otwórz go ponownie.
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.
Wykonaj kroki opisane w poprzedniej sekcji, aby wyeksportować szablon elementu.
Wyodrębnij utworzony plik .zip i otwórz plik vstemplate w programie Visual Studio.
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>W programie Visual Studio zapisz plik vstemplate i zamknij go.
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.
ProjectTypeZnajdź element w pliku vstemplate szablonu elementu.Dodaj element ProjectSubType bezpośrednio po elemecie
ProjectType.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.
Utwórz projekt i element projektu.
Zmodyfikuj element projektu, dopóki nie będzie gotowy do zapisania jako szablonu.
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).
Utwórz plik XML i zapisz go przy użyciu rozszerzenia .vstemplate w tym samym katalogu co plik elementu projektu.
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.
Zapisz plik vstemplate i zamknij go.
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 .
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).