IPersistComponentSettings.SaveSettings Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

IPersistComponentSettings.cs

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, set

Public Property SaveSettings As Boolean

Eigenschaftswert

Boolean

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.

Weitere Informationen

• SaveComponentSettings()
• Save()