Atribut Pengaturan Aplikasi
Arsitektur Application Pengaturan 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.
Catatan
Penyedia pengaturan kustom, yang berasal dari SettingsProvider kelas , hanya diperlukan untuk mengenali tiga atribut berikut: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, dan DefaultSettingValueAttribute.
| Atribut | Target | 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 | Properti | Menentukan string yang dapat dideserialisasi oleh penyedia ke dalam nilai default yang dikodekan secara permanen 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 | Properti | 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 gunakan 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 SettingsManageability enumerasi. |
| SpecialSettingAttribute | Properti | 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 SpecialSetting enumerasi. |
| SettingsSerializeAsAttribute | Keduanya | Menentukan mekanisme serialisasi pilihan untuk grup pengaturan atau properti. Mekanisme serialisasi yang tersedia ditentukan oleh SettingsSerializeAs enumerasi. |
| NoSettingsVersionUpgradeAttribute | Properti | Menentukan bahwa penyedia pengaturan harus menonaktifkan semua fungsionalitas peningkatan aplikasi untuk properti yang ditandai. |
Kelas menunjukkan bahwa atribut hanya dapat diterapkan ke kelas pembungkus pengaturan aplikasi. Properti menunjukkan bahwa atribut hanya dapat diterapkan properti pengaturan. Keduanya menunjukkan bahwa atribut dapat diterapkan di kedua tingkat.
Baca juga
.NET Desktop feedback