Bagikan melalui

Membuat templat item multi-file

  • Artikel

Templat item hanya dapat menentukan satu item, tetapi terkadang item terdiri dari beberapa file. Misalnya, templat item Formulir Windows memerlukan tiga file berikut:

  • File yang berisi kode untuk formulir

  • File yang berisi informasi perancang untuk formulir

  • File yang berisi sumber daya yang disematkan untuk formulir

Templat item multi-file memerlukan parameter untuk memastikan bahwa ekstensi file yang benar digunakan saat item dibuat. Jika Anda membuat templat item multi-file dengan menggunakan Wizard Ekspor Templat, parameter ini dibuat secara otomatis, dan tidak diperlukan pengeditan lebih lanjut.

Menggunakan Wizard Ekspor Templat

Anda dapat membuat templat item multi-file dengan cara yang sama seperti templat item file tunggal. Lihat Cara: Membuat templat item. Pada halaman Pilih Item untuk Diekspor wizard, pilih file yang memiliki file dependen (misalnya, file formulir Formulir Windows). Wizard secara otomatis menyertakan file dependen apa pun, seperti perancang dan file sumber daya, dalam templat.

Membuat templat item multi-file secara manual

  1. Buat templat item seperti yang akan Anda buat secara manual templat item file tunggal, tetapi sertakan setiap file yang merupakan item multi-file.

  2. Dalam file XML .vstemplate, tambahkan ProjectItem elemen untuk setiap file individual, dan tambahkan TargetFileName atribut ke elemen ini. Atur nilai atribut ke TargetFileName$fileinputname$. FileExtension, di mana FileExtension adalah ekstensi file dari file yang disertakan dalam templat. Contoh:

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

    Catatan

    Ketika item yang berasal dari templat ini ditambahkan ke proyek, nama file akan berasal dari nama yang dimasukkan pengguna dalam kotak dialog Tambahkan Item Baru.

  3. Pilih file yang akan disertakan dalam templat Anda, klik kanan pilihan, dan pilih Kirim ke>folder Terkompresi (zip).

    File yang Anda pilih dikompresi ke dalam file .zip .

  4. Salin file .zip ke lokasi templat item pengguna. Secara default, direktorinya adalah %USERPROFILE%\Documents\Visual Studio <Version>\Templates\ItemTemplates. Untuk informasi selengkapnya, lihat Cara: Menemukan dan menata templat.

  5. Tutup Visual Studio lalu buka kembali.

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

    Templat item multi-file muncul dalam kotak dialog Tambahkan Item Baru.

Contoh

Contoh berikut menunjukkan templat Formulir Windows. Saat item dibuat berdasarkan templat ini, nama tiga file yang dibuat akan cocok dengan nama yang dimasukkan dalam kotak dialog Tambahkan Item Baru.

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

Konten terkait