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 示す必要があります。
適用対象
こちらもご覧ください
.NET