ControlAdapter.LoadAdapterControlState メソッド

.NET Framework クラス ライブラリ リファレンス

ControlAdapter.LoadAdapterControlState メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このコントロール アダプタに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterControlState によって保存された、アダプタのコントロール状態情報を読み込みます。

名前空間: System.Web.UI.Adapters
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overridable
 Sub LoadAdapterControlState ( _
    state As Object _
)

Visual Basic (使用法)

Dim state As Object

Me.LoadAdapterControlState(state)

C#

protected internal virtual void LoadAdapterControlState
 (
    Object state
)

C++

protected public:
virtual void LoadAdapterControlState (
    Object^ state
)

J#

protected void LoadAdapterControlState (
    Object state
)

JScript

protected internal function
 LoadAdapterControlState (
    state : Object
)

パラメータ

state

アダプタのコントロールの状態情報を StateBag として格納している Object。

解説

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

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

LoadAdapterControlState メソッドは、有効期間の LoadState の段階で、Control.LoadControlState メソッドの直後に呼び出されます。アダプタのコントロール状態は、独立した、コントロールのコントロール状態に対する追加情報です。

使用例

カスタム アダプタで LoadAdapterControlState メソッドを使用して、以前に保存された状態を読み込んで、状態変数を更新するコード例を次に示します。カスタム アダプタは、プライベート変数 mode を使用してコントロール UI の状態を追跡します。コントロール UI の状態は、未定義 (NoUI)、初期表示 (FirstUI)、またはポストバック (SecondUI) のいずれかになります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlAdapter クラス
ControlAdapter メンバ
System.Web.UI.Adapters 名前空間
Control.LoadControlState
Control クラス
SaveAdapterControlState
LoadAdapterViewState