IPersistComponentSettings.SaveSettings 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出控制項是否應自動保存其應用程式設定屬性。
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
屬性值
如果控制項應該自動保存其狀態,則為 true
,否則為 false
。
範例
下列程式代碼範例顯示控件在嘗試自動保存其設定數據之前檢查 SaveSettings 屬性值的適當方式。
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
備註
如果控件包含元件數據,它通常會保存此數據,以回應方法的明確呼叫 SaveComponentSettings ,或有時在叫用控件的 Dispose 方法時隱含地保存此數據。 屬性 SaveSettings 會決定控件在處置時是否自動保存其組態數據。
的 SaveSettings 預設值取決於控件的實作。 控制件的檔案應該指出它是否使用應用程式設定、保存哪些數據,以及屬性的 SaveSettings 預設值為何。