Control.EnableViewState Property
Assembly: System.Web (in system.web.dll)
'Declaration <ThemeableAttribute(False)> _ Public Overridable Property EnableViewState As Boolean 'Usage Dim instance As Control Dim value As Boolean value = instance.EnableViewState instance.EnableViewState = value
/** @property */ public boolean get_EnableViewState () /** @property */ public void set_EnableViewState (boolean value)
public function get EnableViewState () : boolean public function set EnableViewState (value : boolean)
Not applicable.
Property Value
true if the server control maintains its view state; otherwise false. The default is true.You must enable view state for the server control to maintain its state across HTTP requests.
A server control's view state is the accumulation of all its property values. In order to preserve these values across HTTP requests, ASP.NET uses an instance of the StateBag class to store the property values. The values are then passed as a variable to a hidden field when subsequent requests are processed. For more information about view state, see View State Overview.
There are times when it is appropriate to disable view state, particularly to improve application performance. For example, if you are loading a database request into a server control, set this property to false. If you do not, processor time will be wasted loading view state into the server control that will only be overridden by the database query. If EnableViewState is false, you can use the control state to persist property information that is specific to a control and cannot be turned off like the view state property. For more information on the difference between control state and view state, see Control State vs. View State Sample. For information on new state management functionality in ASP.NET 2.0, see What's New in ASP.NET State Management.
For information about how to enable or disable view state declaratively for an ASP.NET page, see @ Page.
The following example sets the EnableViewState property to false.
Sub Page_Load(sender As Object, e As System.EventArgs) DataBind() ' Set EnableViewState to false to disable saving of view state ' information. myControl.EnableViewState = False If Not IsPostBack Then display.Enabled = False End If End Sub
void Page_Load(Object sender, System.EventArgs e)
{
DataBind();
// Set EnableViewState to false to disable saving of view state
// information.
myControl.set_EnableViewState(false);
if (!(get_IsPostBack())) {
display.set_Enabled(false);
}
} //Page_Load
Reference
Control ClassControl Members
System.Web.UI Namespace
ViewState
LoadViewState
SaveViewState
IsViewStateEnabled
Other Resources
@ PageIntroduction to the ASP.NET Page Life Cycle
ASP.NET State Management
ASP.NET State Management Overview
Control State vs. View State Sample
What's New in ASP.NET State Management