IPersistComponentSettings.SaveSettings Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość wskazującą, czy kontrolka powinna automatycznie utrwalać jej właściwości ustawień aplikacji.
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
Wartość właściwości
true
jeśli kontrolka powinna automatycznie utrwalić jego stan; w przeciwnym razie , false
.
Przykłady
Poniższy przykład kodu przedstawia odpowiedni sposób sprawdzania wartości SaveSettings właściwości przed próbą automatycznego utrwalania danych konfiguracji.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Uwagi
Jeśli kontrolka zawiera dane konfiguracji, zwykle będzie ona utrwalać te dane w odpowiedzi na jawne wywołanie SaveComponentSettings metody lub czasami niejawnie po wywołaniu metody kontrolki Dispose . Właściwość określa, czy kontrolka SaveSettings automatycznie utrwala swoje dane konfiguracji podczas usuwania.
Wartość domyślna zależy SaveSettings od implementacji kontrolki. Dokumentacja kontrolki powinna wskazywać, czy używa ona ustawień aplikacji, jakie dane są utrwalane i jaka jest domyślna wartość SaveSettings właściwości.