Control.LoadViewStateByID Property

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

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

protected bool LoadViewStateByID { get; }
/** @property */
protected boolean get_LoadViewStateByID ()

protected function get LoadViewStateByID () : boolean

Not applicable.

Property Value

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

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.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0