IPersistComponentSettings.SaveSettings プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロールのアプリケーション設定プロパティを自動的に保持するかどうかを示す値を取得または設定します。
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 Booleanプロパティ値
コントロールの状態を自動的に保持する場合は true。それ以外の場合は false。
例
次のコード例は、コントロールが構成データを自動的に永続化する前に、プロパティの SaveSettings 値を確認する適切な方法を示しています。
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
注釈
コントロールに構成データが含まれている場合は、通常、メソッドの明示的な呼び出しに応答して、またはコントロールDisposeのメソッドが呼びSaveComponentSettings出されたときに暗黙的にこのデータを保持します。 このプロパティは SaveSettings 、コントロールが破棄されるときに、その構成データを自動的に保持するかどうかを決定します。
既定値 SaveSettings は、コントロールの実装によって異なります。 コントロールのドキュメントでは、アプリケーション設定を使用するかどうか、保持されるデータ、およびプロパティの既定値を示す SaveSettings 必要があります。