System.Web.UI.Adapters.ControlAdapter.LoadAdapterViewState Method

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

Syntax

protected virtual void LoadAdapterViewState (object state)

Parameters

state
An object that contains the adapter view state information as a System.Web.UI.StateBag.

Remarks

When an adapter needs to maintain its own view state information, it can override the ControlAdapter.LoadAdapterViewState(object) and ControlAdapter.SaveAdapterViewState methods.

An adapter needs to maintain view state information when there is data that must be maintained across requests, independent from the view state of the associated control. For example, a grid control on desktop computer browsers might render as a single view of rows and columns of values. On other browsers, it might split its rendering into multiple separate views, such as a list of rows and details of a single row. The adapter would need to maintain the data for the views that are not currently active in view state.

The ControlAdapter.LoadAdapterViewState(object) method is called immediately before the System.Web.UI.Control.LoadViewState(object) method in the LoadState lifecycle stage. The adapter view state is separate and in addition to the view state of the control.

Requirements

Namespace: System.Web.UI.Adapters
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0