Membuat kategori pengaturan

Artikel
01/12/2024

Dalam panduan ini, Anda membuat kategori pengaturan Visual Studio dan menggunakannya untuk menyimpan nilai dan memulihkan nilai dari file pengaturan. Kategori pengaturan adalah sekelompok properti terkait yang muncul sebagai "titik pengaturan kustom"; yaitu, sebagai kotak centang dalam wizard impor dan ekspor Pengaturan. (Anda dapat menemukannya di Menu alat.) Pengaturan disimpan atau dipulihkan sebagai kategori, dan pengaturan individual tidak ditampilkan dalam wizard. Untuk informasi selengkapnya, lihat Pengaturan lingkungan.

Anda membuat kategori pengaturan dengan mengambilnya dari DialogPage kelas .

Untuk memulai panduan ini, Anda harus terlebih dahulu menyelesaikan bagian pertama halaman Buat Opsi. Kisi properti Opsi yang dihasilkan memungkinkan Anda memeriksa dan mengubah properti dalam kategori. Setelah menyimpan kategori properti dalam file pengaturan, Anda memeriksa file untuk melihat bagaimana nilai properti disimpan.

Membuat kategori pengaturan

Di bagian ini, Anda menggunakan titik pengaturan kustom untuk menyimpan dan memulihkan nilai kategori pengaturan.

Untuk membuat kategori pengaturan

Selesaikan halaman Buat Opsi.
Buka file VSPackage.resx dan tambahkan tiga sumber daya string ini:

Nama Nilai

106 Kategori Saya

107 Pengaturan Saya

108 OptionInteger dan OptionFloat

Ini membuat sumber daya yang memberi nama kategori "Kategori Saya", objek "My Pengaturan", dan deskripsi kategori "OptionInteger dan OptionFloat".

Catatan

Dari ketiganya, hanya nama kategori yang tidak muncul dalam wizard impor dan ekspor Pengaturan.

Di MyToolsOptionsPackage.cs, tambahkan float properti bernama OptionFloat ke OptionPageGrid kelas , seperti yang ditunjukkan dalam contoh berikut.

public class OptionPageGrid : DialogPage
{
    private int optionInt = 256;
    private float optionFloat = 3.14F;

    [Category("My Options")]
    [DisplayName("My Integer option")]
    [Description("My integer option")]
    public int OptionInteger
    {
        get { return optionInt; }
        set { optionInt = value; }
    }
    [Category("My Options")]
    [DisplayName("My Float option")]
    [Description("My float option")]
    public float OptionFloat
    {
        get { return optionFloat; }
        set { optionFloat = value; }
    }
}

Catatan

Kategori OptionPageGrid bernama "Kategori Saya" sekarang terdiri dari dua properti, OptionInteger dan OptionFloat.

ProvideProfileAttribute Tambahkan ke MyToolsOptionsPackage kelas dan berikan CategoryName "Kategori Saya", berikan ObjectName "My Pengaturan", dan atur isToolsOptionPage ke true. Atur categoryResourceID, objectNameResourceID, dan DescriptionResourceID ke ID sumber daya string yang sesuai yang dibuat sebelumnya.
```
[ProvideProfileAttribute(typeof(OptionPageGrid),
    "My Category", "My Settings", 106, 107, isToolsOptionPage:true, DescriptionResourceID = 108)]
```
Bangun proyek dan mulai penelusuran kesalahan. Dalam instans eksperimental, Anda akan melihat bahwa Halaman Kisi Saya sekarang memiliki nilai bilangan bulat dan float.

Memeriksa file pengaturan

Di bagian ini, Anda mengekspor nilai kategori properti ke file pengaturan. Anda memeriksa file lalu mengimpor kembali nilai ke dalam kategori properti.

Mulai proyek dalam mode debug dengan menekan F5. Ini memulai instans eksperimental.
Buka dialog Opsi Alat>.
Dalam tampilan pohon di panel kiri, perluas Kategori Saya lalu klik Halaman Kisi Saya.
Ubah nilai OptionFloat menjadi 3.1416 dan OptionInteger menjadi 12. Klik OK.
Pada menu Alat, klik Impor dan Ekspor Pengaturan.

Wizard impor dan ekspor Pengaturan muncul.
Pastikan Ekspor pengaturan lingkungan yang dipilih dipilih, lalu klik Berikutnya.

Halaman Pilih Pengaturan untuk Diekspor muncul.
Klik Pengaturan Saya.

Deskripsi berubah menjadi OptionInteger dan OptionFloat.
Pastikan Pengaturan Saya adalah satu-satunya kategori yang dipilih, lalu klik Berikutnya.

Halaman Nama File Pengaturan Anda muncul.
Beri nama file pengaturan baru My Pengaturan.vssettings dan simpan di direktori yang sesuai. Klik Selesai.

File .vssettings adalah file pengaturan Visual Studio. Skema file terbuka. Paling umum, skema mengikuti struktur XML di mana setiap kategori adalah tag, yang dapat dengan sendirinya berisi tag subkategori. Tag sub-kategori ini dapat berisi tag nilai properti. Meskipun sebagian besar paket menggunakan struktur umum, paket apa pun di Visual Studio dapat berkontribusi XML arbitrer ke file dengan skema yang dipilihnya.

Halaman Ekspor Selesai melaporkan bahwa pengaturan Anda berhasil diekspor.
Pada menu File , arahkan ke Buka, lalu klik File. Temukan My Pengaturan.vssettings dan buka.

Anda dapat menemukan kategori properti yang Anda ekspor di bagian file berikut (GUID Anda akan berbeda).
```
<Category name="My Category_My Settings"
      Category="{4802bc3e-3d9d-4591-8201-23d1a05216a6}"
      Package="{6bb6942e-014c-489e-a612-a935680f703d}"
      RegisteredName="My Category_My Settings">
      PackageName="MyToolsOptionsPackage">
   <PropertyValue name="OptionFloat">3.1416</PropertyValue>
   <PropertyValue name="OptionInteger">12</PropertyValue>
</Category>
```
Perhatikan bahwa nama kategori lengkap dibentuk oleh penambahan garis bawah ke nama kategori diikuti dengan nama objek. OptionFloat dan OptionInteger muncul dalam kategori, bersama dengan nilai yang diekspor.
Tutup file pengaturan tanpa mengubahnya.
Pada menu Alat, klik Opsi, perluas Kategori Saya, klik Halaman Kisi Saya lalu ubah nilai OptionFloat menjadi 1.0 dan OptionInteger menjadi 1. Klik OK.
Pada menu Alat, klik Impor dan Ekspor Pengaturan, pilih Impor pengaturan lingkungan yang dipilih, lalu klik Berikutnya.

Halaman Simpan Pengaturan Saat Ini muncul.
Pilih Tidak, cukup impor pengaturan baru lalu klik Berikutnya.

Halaman Pilih Kumpulan Pengaturan untuk Diimpor muncul.
Pilih file My Pengaturan.vssettings di node My Pengaturan tampilan pohon. Jika file tidak muncul di tampilan pohon, klik Telusuri dan temukan. Klik Berikutnya.

Kotak dialog Pilih Pengaturan untuk Diimpor muncul.
Pastikan Pengaturan Saya dipilih, lalu klik Selesai. Saat halaman Impor Selesai muncul, klik Tutup.
Pada menu Alat , klik Opsi, perluas Kategori Saya, klik Halaman Kisi Saya dan verifikasi bahwa nilai kategori properti telah dipulihkan.