ControlAdapter.SaveAdapterControlState メソッド

定義

コントロール アダプターのコントロール状態情報を保存します。

protected public:
 virtual System::Object ^ SaveAdapterControlState();
protected internal virtual object SaveAdapterControlState();
abstract member SaveAdapterControlState : unit -> obj
override this.SaveAdapterControlState : unit -> obj
Protected Friend Overridable Function SaveAdapterControlState () As Object

返品

アダプターの制御状態情報をStateBagとして格納するObject

注釈

制御状態は、ビューステートが無効になっている場合でも必要な重要な状態情報です。 アダプターは、独自の制御状態情報を維持する必要がある場合、 SaveAdapterControlState メソッドと LoadAdapterControlState メソッドをオーバーライドできます。

アダプターは、関連付けられているコントロールの状態とは無関係に、要求間で状態を維持する必要がある機能がある場合に、コントロールの状態情報を維持する必要がある場合があります。 たとえば、大きなテキスト表示と RadioButton コントロールのグループで構成される複合コントロールは、デスクトップ コンピューター ブラウザーで単一のビューとしてレンダリングされる場合があります。 他のブラウザーでは、レンダリングが分割される場合があります。一方のビューはテキスト表示用で、もう 1 つはラジオ ボタン グループ用です。 アダプターは、現在アクティブなビューに関する独自のターゲット固有の情報を保持する必要があります。

SaveAdapterControlState メソッドは、SaveState ライフサイクル ステージの Control.SaveControlState メソッドの直後に呼び出されます。 アダプターの制御状態は、コントロールの制御状態に加えて、独立しています。

適用対象

こちらもご覧ください