Control.LoadViewStateByID Property

Definition

Gets a value indicating whether the control participates in loading its view state by ID instead of index.

protected:
 property bool LoadViewStateByID { bool get(); };
protected bool LoadViewStateByID { get; }
member this.LoadViewStateByID : bool
Protected ReadOnly Property LoadViewStateByID As Boolean

Property Value

true if the control loads its view state by ID; otherwise, false. The default value is false.

Remarks

By default, when a parent control loads view state into child controls it creates, it does this by the position of each child control in the parent control's Controls collection. When view state is initially applied, all child controls might not have been created. In this case, the view state for controls not yet created is saved, and applied when the child controls are created later.

For a parent control to apply view state to its child controls, two conditions must be met:

  • On postback, the parent control must create the child controls in exactly the same order as the previous request so that the order of the controls remains consistent.

  • After postback, any child controls created must be added to the end of the parent control's Controls collection.

If these two conditions cannot be met, as in the case of the delayed creation of a child control, the parent control can load view state by using ID. To set the LoadViewStateByID property to true, use the ViewStateModeByIdAttribute metadata attribute for the parent control.

Applies to

See also