Bagikan melalui

Membuat templat item

  • Artikel

Artikel ini memperlihatkan kepada Anda cara membuat templat item dengan menggunakan Wizard Ekspor Templat. Jika templat Anda akan terdiri dari beberapa file, lihat Cara: Membuat templat item multi-file.

Tambahkan templat item ke kotak dialog Tambahkan Item Baru

  1. Membuat atau membuka proyek di Visual Studio.

  2. Tambahkan item ke proyek, dan ubah jika Anda mau.

  3. Ubah file kode untuk menunjukkan di mana penggantian parameter harus dilakukan. Untuk informasi selengkapnya, lihat Cara: Mengganti parameter dalam templat.

  4. Pada menu Proyek , pilih Ekspor Templat.

  5. Pada halaman Pilih Jenis Templat, pilih Templat Item, pilih proyek yang berisi item, lalu pilih Berikutnya.

  6. Pada halaman Pilih Item yang Akan Diekspor , pilih item yang ingin Anda buat templatnya, lalu pilih Berikutnya.

  7. Pada halaman Pilih Referensi Item, pilih referensi rakitan untuk disertakan dalam templat, lalu pilih Berikutnya.

  8. Pada halaman Pilih Opsi Templat, masukkan nama templat dan deskripsi opsional, gambar ikon dan gambar pratinjau, lalu pilih Selesai. File ikon untuk item adalah file, seperti yang .ico dijelaskan dalam Gambar dan ikon untuk Visual Studio - jenis file. Gambar pratinjau adalah gambar 200 x 200 yang akan muncul di kotak dialog Tambahkan Item Baru.

    Anda dapat melihat di pustaka gambar Visual Studio untuk ikon yang konsisten dengan gaya Visual Studio.

    File untuk templat ditambahkan ke file .zip dan disalin ke direktori yang Anda tentukan dalam wizard. Lokasi defaultnya adalah %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

  9. Jika Anda tidak memilih opsi Impor templat secara otomatis ke Visual Studio di Wizard Ekspor Templat, temukan templat yang diekspor. Kemudian, salin ke direktori templat item pengguna. Lokasi defaultnya adalah %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

  10. Tutup Visual Studio lalu buka kembali.

  11. Buat proyek baru, atau buka proyek yang sudah ada, lalu pilih Proyek>Tambahkan Item Baru atau tekan Ctrl+Shift+A.

    Templat item muncul dalam kotak dialog Tambahkan Item Baru. Jika Anda menambahkan deskripsi di Wizard Ekspor Templat, deskripsi akan muncul di sisi kanan kotak dialog.

Mengaktifkan templat item yang akan digunakan dalam proyek Aplikasi Windows Universal

Wizard melakukan banyak pekerjaan untuk membuat templat dasar, tetapi dalam banyak kasus Anda perlu memodifikasi file .vstemplate secara manual setelah Anda mengekspor templat. Misalnya, jika Anda ingin item muncul dalam dialog Tambahkan Item Baru untuk proyek Aplikasi Windows Universal, Anda harus melakukan beberapa langkah tambahan.

  1. Ikuti langkah-langkah di bagian sebelumnya untuk mengekspor templat item.

  2. Ekstrak file .zip yang dibuat, dan buka file .vstemplate di Visual Studio.

  3. Untuk proyek C# Universal Windows, tambahkan XML berikut di <TemplateData> dalam elemen :

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

  4. Di Visual Studio, simpan file .vstemplate dan tutup.

  5. Salin dan tempel file .vstemplate kembali ke file .zip .

    Jika kotak dialog Salin File muncul, pilih opsi Salin dan Ganti .

Sekarang Anda bisa menambahkan item berdasarkan templat ini ke proyek Universal Windows dari kotak dialog Tambahkan Item Baru.

Mengaktifkan templat untuk subjenis proyek tertentu

Anda bisa menentukan bahwa templat Anda seharusnya hanya muncul untuk subjenis proyek tertentu, seperti Windows, Office, Database, atau Web.

  1. ProjectType Temukan elemen dalam file .vstemplate untuk templat item.

  2. Tambahkan elemen ProjectSubType segera setelah ProjectType elemen .

  3. Atur nilai teks elemen ke salah satu nilai berikut:

    • Windows
    • Office
    • Database
    • Web

Misalnya: <ProjectSubType>Database</ProjectSubType>.

Contoh berikut ini memperlihatkan templat item untuk proyek 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>

Membuat templat item secara manual

Dalam beberapa kasus, Anda mungkin ingin membuat templat item secara manual, dari awal.

  1. Buat item proyek dan proyek.

  2. Ubah item proyek hingga siap disimpan sebagai templat.

  3. Ubah file kode untuk menunjukkan di mana penggantian parameter harus terjadi, jika di mana saja. Untuk informasi selengkapnya tentang penggantian parameter, lihat Cara: Mengganti parameter dalam templat.

  4. Buat file XML dan simpan dengan ekstensi file .vstemplate di direktori yang sama dengan file item proyek Anda.

  5. Edit file XML .vstemplate untuk menyediakan metadata templat item. Untuk informasi selengkapnya, lihat Referensi skema templat (ekstensibilitas) dan contoh di bagian sebelumnya.

  6. Simpan file .vstemplate dan tutup.

  7. Di Windows Explorer, pilih file yang ingin Anda sertakan dalam templat Anda. Klik kanan pilihan, dan pilih Kirim ke>folder Terkompresi (zip). File yang Anda pilih dikompresi ke dalam file .zip .

  8. Salin file .zip dan tempelkan di lokasi templat item pengguna. Direktori default adalah %USERPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates. Untuk informasi selengkapnya, lihat Cara: Menemukan dan menata templat proyek dan item.

Konten terkait