ControlAdapter.SaveAdapterViewState Method

Definition

Saves view state information for the control adapter.

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

Returns

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 SaveAdapterViewState and LoadAdapterViewState methods.

An adapter needs to maintain view state information when there is data that must be maintained across requests, independent from the associated view state of the 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 SaveAdapterViewState method is called immediately before the Control.SaveViewState method in the SaveState lifecycle stage. The adapter view state is separate and in addition to the view state of the control.

Applies to

See also