IPersistComponentSettings.SaveSettings Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob das Steuerelement die Eigenschaften seiner Anwendungseinstellungen automatisch beibehalten soll, oder legt diesen Wert fest.
public:
property bool SaveSettings { bool get(); void set(bool value); };public bool SaveSettings { get; set; }member this.SaveSettings : bool with get, setPublic Property SaveSettings As BooleanEigenschaftswert
true, wenn das Steuerelement automatisch seinen Zustand beibehalten soll, andernfalls false.
Beispiele
Das folgende Codebeispiel zeigt, wie ein Steuerelement den Wert der SaveSettings Eigenschaft überprüfen kann, bevor es versucht, seine Konfigurationsdaten automatisch beizubehalten.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Hinweise
Wenn ein Steuerelement Konfigurationsdaten enthält, werden diese Daten in der Regel als Reaktion auf einen expliziten Aufruf der SaveComponentSettings -Methode oder manchmal implizit beibehalten, wenn die -Methode des Steuerelements Dispose aufgerufen wird. Die SaveSettings -Eigenschaft bestimmt, ob ein Steuerelement seine Konfigurationsdaten automatisch speichert, wenn es verworfen wird.
Der Standardwert von SaveSettings hängt von der Implementierung des Steuerelements ab. In der Dokumentation für das Steuerelement sollte angegeben werden, ob Anwendungseinstellungen verwendet werden, welche Daten beibehalten werden und welcher Standardwert die SaveSettings Eigenschaft ist.
