ControlAdapter.SaveAdapterControlState メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロール アダプターのコントロール状態情報を保存します。
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 メソッドの直後に呼び出されます。 アダプターの制御状態は、コントロールの制御状態に加えて、独立しています。