This documentation is archived and is not being maintained.

ControlAdapter.SaveAdapterControlState Method

Saves control state information for the control adapter.

Namespace: System.Web.UI.Adapters
Assembly: System.Web (in system.web.dll)

protected internal virtual Object SaveAdapterControlState ()
protected Object SaveAdapterControlState ()
protected internal function SaveAdapterControlState () : Object
Not applicable.

Return Value

An Object that contains the adapter's control state information as a StateBag.

Control state is the essential state information needed even if view state is disabled. When an adapter needs to maintain its own control state information, it can override the SaveAdapterControlState and LoadAdapterControlState methods.

An adapter might need to maintain control state information when there are features that need to have state maintained across requests, independent from the state of the associated control. For example, a composite control consisting of a large textual display and a group of RadioButton controls might render as a single view on desktop computer browsers. On other browsers, it might split its rendering—one view for the textual display and the other for the radio button group. The adapter would need to maintain its own target-specific information about the currently active view.

The SaveAdapterControlState method is called immediately after the Control.SaveControlState method in the SaveState lifecycle stage. The adapter control state is separate and in addition to the control state of the control.

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0