ControlAdapter.SaveAdapterControlState メソッド
アセンブリ: System.Web (system.web.dll 内)

Dim returnValue As Object returnValue = Me.SaveAdapterControlState
アダプタのコントロール状態情報を StateBag として格納している Object。

コントロールの状態は、重要な状態情報で、ビューステートが無効になっていても必要です。アダプタが独自のコントロール状態情報を維持する必要がある場合、アダプタで SaveAdapterControlState メソッドおよび LoadAdapterControlState メソッドをオーバーライドできます。
複数の要求にわたって状態を維持することが必要な機能がある場合、アダプタは、関連付けられたコントロールの状態とは別に、コントロール状態情報を維持する必要があります。たとえば、大量のテキスト表示と RadioButton コントロールのグループで構成される複合コントロールは、デスクトップ コンピュータのブラウザでは、単一のビューとして表示されます。他のブラウザでは、たとえばテキスト表示に 1 つのビュー、オプション ボタン グループに別のビュー、と分割表示されます。アダプタは、現在アクティブなビューに関する独自のターゲット固有情報を維持する必要があります。
SaveAdapterControlState メソッドは、有効期間の SaveState の段階で、Control.SaveControlState メソッドの直後に呼び出されます。アダプタのコントロール状態は、独立した、コントロールのコントロール状態に対する追加情報です。

LoadAdapterControlState メソッドと共に SaveAdapterControlState メソッドを使用する方法を次のコード例に示します。 アダプタは、プライベート変数 mode を使用してコントロール UI の状態を追跡します。コントロール UI の状態は、未定義 (NoUI)、初期表示 (FirstUI)、またはポストバック (SecondUI) のいずれかになります。SaveAdapterControlState メソッドは、mode 変数をボックス化し、それをオブジェクトとして返します。このオブジェクトは、LoadAdapterControlState メソッドが、ページの読み込み時にアダプタの現在のモードを確認するために使用します。

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- ControlAdapter.SaveAdapterControlState メソッドのページへのリンク