This documentation is archived and is not being maintained.

ControlAdapter.LoadAdapterControlState Method

Loads adapter control state information that was saved by SaveAdapterControlState during a previous request to the page where the control associated with this control adapter resides.

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

protected internal virtual void LoadAdapterControlState(
	Object state


Type: System.Object
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 LoadAdapterControlState and SaveAdapterControlState 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 LoadAdapterControlState method is called immediately after the Control.LoadControlState method, in the LoadState lifecycle stage. The adapter control state is separate and in addition to the control state of the control.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.