Export (0) Print
Expand All
2 out of 5 rated this helpful - Rate this topic

Control.EnableViewState Property

Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property EnableViewState As Boolean

Property Value

Type: System.Boolean
true if the server control maintains its view state; otherwise false. The default is true.

View state enables a server control to maintain its state across HTTP requests. View state for a control is enabled if all of the following conditions are met:

  • The EnableViewState property for the page is set to true.

  • The EnableViewState property for the control is set to true.

  • The ViewStateMode property for the control is set to Enabled or inherits the Enabled setting.

For more information, see the ViewStateMode property.

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 ASP.NET 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 Example.

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


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.