Bagikan melalui

Atribut Pengaturan Aplikasi

Arsitektur Pengaturan Aplikasi menyediakan banyak atribut yang dapat diterapkan baik ke kelas pembungkus pengaturan aplikasi atau properti individualnya. Atribut ini diperiksa pada waktu proses oleh infrastruktur pengaturan aplikasi, seringkali secara khusus penyedia pengaturan, untuk menyesuaikan fungsinya dengan kebutuhan pembungkus kustom yang dinyatakan.

Tabel berikut mencantumkan atribut yang dapat diterapkan ke kelas pembungkus pengaturan aplikasi, properti individual kelas ini, atau keduanya. Menurut definisi, hanya atribut cakupan tunggal—UserScopedSettingAttribute atau ApplicationScopedSettingAttribute—harus diterapkan ke setiap properti pengaturan.

Nota

Penyedia pengaturan kustom, yang berasal dari kelas SettingsProvider, hanya diperlukan untuk mengenali tiga atribut berikut: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, dan DefaultSettingValueAttribute.

Karakteristik Sasaran Deskripsi
SettingsProviderAttribute Keduanya Menentukan nama pendek penyedia pengaturan yang akan digunakan untuk persistensi.

Jika atribut ini tidak disediakan, penyedia default, LocalFileSettingsProvider, diasumsikan.
UserScopedSettingAttribute Keduanya Menentukan properti sebagai pengaturan aplikasi yang dilingkup pengguna.
ApplicationScopedSettingAttribute Keduanya Mendefinisikan properti sebagai pengaturan aplikasi yang dilingkup aplikasi.
DefaultSettingValueAttribute Harta benda Menentukan string yang dapat dideserialisasi oleh penyedia layanan menjadi nilai default tetap untuk properti ini.

LocalFileSettingsProvider tidak memerlukan atribut ini, dan akan mengambil alih nilai apa pun yang disediakan oleh atribut ini jika ada nilai yang sudah dipertahankan.
SettingsDescriptionAttribute Harta benda Menyediakan pengujian deskriptif untuk pengaturan individual, terutama digunakan oleh alat run-time dan design-time.
SettingsGroupNameAttribute Kelas Menyediakan nama eksplisit untuk grup pengaturan. Jika atribut ini hilang, ApplicationSettingsBase menggunakan nama kelas pembungkus.
SettingsGroupDescriptionAttribute Kelas Menyediakan pengujian deskriptif untuk grup pengaturan, yang digunakan terutama oleh alat run-time dan design-time.
SettingsManageabilityAttribute Keduanya Menentukan nol atau lebih layanan pengelolaan yang harus diberikan ke grup pengaturan atau properti. Layanan yang tersedia dijelaskan oleh enumerasi SettingsManageability.
SpecialSettingAttribute Harta benda Menunjukkan bahwa pengaturan termasuk dalam kategori khusus yang telah ditentukan sebelumnya, seperti string koneksi, yang menyarankan pemrosesan khusus oleh penyedia pengaturan. Kategori yang telah ditentukan sebelumnya untuk atribut ini ditentukan oleh enumerasi SpecialSetting.
SettingsSerializeAsAttribute Keduanya Menentukan mekanisme serialisasi pilihan untuk grup pengaturan atau properti. Mekanisme serialisasi yang tersedia ditentukan oleh enumerasi SettingsSerializeAs.
NoSettingsVersionUpgradeAttribute Harta benda Menentukan bahwa penyedia pengaturan harus menonaktifkan semua fungsionalitas peningkatan aplikasi untuk properti yang ditandai.

Class menunjukkan bahwa atribut hanya dapat diterapkan ke kelas pembungkus pengaturan aplikasi. Properti menunjukkan bahwa atribut hanya dapat diterapkan pada properti yang berkaitan dengan pengaturan. Kedua menunjukkan bahwa atribut dapat diterapkan di kedua tingkat.

Lihat juga

  • Last updated on