ControlAdapter.LoadAdapterViewState(Object) Method

Definition

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

protected public:
 virtual void LoadAdapterViewState(System::Object ^ state);
protected internal virtual void LoadAdapterViewState (object state);
abstract member LoadAdapterViewState : obj -> unit
override this.LoadAdapterViewState : obj -> unit
Protected Friend Overridable Sub LoadAdapterViewState (state As Object)

Parameters

state
Object

An Object that contains the adapter view state information as a StateBag.

Remarks

When an adapter needs to maintain its own view state information, it can override the LoadAdapterViewState and 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 LoadAdapterViewState method is called immediately before the Control.LoadViewState method in the LoadState lifecycle stage. The adapter view state is separate and in addition to the view state of the control.

Applies to

See also