IPersistComponentSettings インターフェイス

定義

アプリケーション設定の格納および取得を行うコントロールまたはライブラリの標準機能を定義します。Defines standard functionality for controls or libraries that store and retrieve application settings.

public interface class IPersistComponentSettings
public interface IPersistComponentSettings
type IPersistComponentSettings = interface
Public Interface IPersistComponentSettings

注釈

通常は、からApplicationSettingsBase派生した設定ラッパークラスを作成し、このクラスに特別なプロパティを追加することによって、アプリケーションにアプリケーション設定のサポートを追加できます。Typically, you can add application settings support to an application by creating a settings wrapper class, which is derived from ApplicationSettingsBase, and then add special properties to this class. ただし、この方法では、コンテナーが詳細からシールドされるように、コントロールのアプリケーション設定を十分にカプセル化することはできません。However, this approach does not sufficiently encapsulate application settings for a control so that its container is shielded from the details. インターフェイスIPersistComponentSettingsは、アプリケーション設定の状態変更要求をコントロール、コンポーネント、またはライブラリモジュールに通信するための標準インターフェイスをアプリケーションに提供します。The IPersistComponentSettings interface provides an application with a standard interface for communicating application settings state change requests to a control, component, or library module. デザイン時ツールは、このインターフェイスにも依存して、コントロールとコンポーネントを適切に管理します。Design-time tools also depend on this interface to properly manage controls and components.

プロパティ

SaveSettings

コントロールのアプリケーション設定プロパティを自動的に保持するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the control should automatically persist its application settings properties.

SettingsKey

コントロールの現在のインスタンスのアプリケーション設定キーの値を取得または設定します。Gets or sets the value of the application settings key for the current instance of the control.

メソッド

LoadComponentSettings()

コントロールのアプリケーション設定を対応するプロパティに読み込み、コントロールの状態を更新します。Reads the control's application settings into their corresponding properties and updates the control's state.

ResetComponentSettings()

コントロールのアプリケーション設定プロパティを既定値にリセットします。Resets the control's application settings properties to their default values.

SaveComponentSettings()

コントロールのアプリケーション設定プロパティを保持します。Persists the control's application settings properties.

適用対象

こちらもご覧ください