IPersistComponentSettings.SaveSettings Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol harus secara otomatis mempertahankan properti pengaturan aplikasinya.
public:
property bool SaveSettings { bool get(); void set(bool value); };
public bool SaveSettings { get; set; }
member this.SaveSettings : bool with get, set
Public Property SaveSettings As Boolean
Nilai Properti
true
jika kontrol harus secara otomatis mempertahankan statusnya; jika tidak, false
.
Contoh
Contoh kode berikut menunjukkan cara yang tepat bagi kontrol untuk memeriksa nilai SaveSettings properti sebelum mencoba mempertahankan data konfigurasinya secara otomatis.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Keterangan
Jika kontrol berisi data konfigurasi, biasanya akan mempertahankan data ini sebagai respons terhadap panggilan eksplisit ke SaveComponentSettings metode atau kadang-kadang secara implisit ketika metode kontrol Dispose dipanggil. Properti SaveSettings menentukan apakah kontrol secara otomatis mempertahankan data konfigurasinya saat dibuang.
Nilai SaveSettings default tergantung pada implementasi kontrol. Dokumentasi untuk kontrol harus menunjukkan apakah ia menggunakan pengaturan aplikasi, data apa yang dipertahankan, dan apa nilai SaveSettings default properti.