Share via


ApplicationSettingsBase.SettingsKey Properti

Definisi

Mendapatkan atau mengatur kunci pengaturan untuk grup pengaturan aplikasi.

public:
 property System::String ^ SettingsKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string SettingsKey { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.SettingsKey : string with get, set
Public Property SettingsKey As String

Nilai Properti

yang String berisi kunci pengaturan untuk grup pengaturan saat ini.

Atribut

Keterangan

SettingsKey Properti disediakan untuk mengaktifkan kode klien, dan khususnya penyedia pengaturan, untuk membedakan antara beberapa instans kelas pengaturan aplikasi yang sama.

Kecuali kelas pembungkus pengaturan dirancang menggunakan pola singleton, mungkin ada beberapa instans dari kelas pengaturan aplikasi yang sama dalam satu aplikasi. Nilai SettingsKey harus diatur sesuai dengan bagaimana nilai properti dimaksudkan untuk dibagikan.

  • Jika properti pengaturan pembungkus dimaksudkan untuk dibagikan di semua instans pembungkus dalam aplikasi yang sama, maka SettingsKey harus memiliki nilai yang sama di semua instans. Ini adalah perilaku ApplicationSettingsBase default kelas.

  • Jika properti pengaturan pembungkus dimaksudkan untuk per instans, maka SettingsKey harus memiliki nilai unik untuk setiap instans. Versi ApplicationSettingsBase(String) konstruktor memungkinkan Anda menginisialisasi SettingsKey ke string unik.

Sebaliknya, Context properti memberikan petunjuk kepada penyedia pengaturan untuk memungkinkannya mempertahankan nilai secara efisien dan tertib.

Kelas SettingChangingEventArgs berisi properti serupa SettingKey yang membantu mengidentifikasi sumber SettingChanging peristiwa.

Berlaku untuk

Lihat juga