Bagikan melalui

Atribut Pengaturan Aplikasi

  • Artikel

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