IPersistComponentSettings.SaveSettings Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označující, zda má ovládací prvek automaticky zachovat vlastnosti nastavení aplikace.
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
Hodnota vlastnosti
true
pokud má ovládací prvek automaticky zachovat svůj stav; v opačném případě . false
Příklady
Následující příklad kódu ukazuje správný způsob, jak ovládací prvek zkontrolovat hodnotu SaveSettings vlastnosti předtím, než se pokusí automaticky zachovat konfigurační data.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Poznámky
Pokud ovládací prvek obsahuje konfigurační data, obvykle tato data zachovají v reakci na explicitní volání SaveComponentSettings metody nebo někdy implicitně při vyvolání metody ovládacího prvku Dispose . Vlastnost SaveSettings určuje, zda ovládací prvek při odstranění automaticky uchovává konfigurační data.
Výchozí hodnota závisí SaveSettings na implementaci ovládacího prvku. V dokumentaci k ovládacímu prvku by mělo být uvedeno, jestli používá nastavení aplikace, jaká data jsou trvale uložená a jaká je výchozí hodnota SaveSettings vlastnosti.