Control.EnableViewState 属性

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };

[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.EnableViewState : bool with get, set

Public Overridable Property EnableViewState As Boolean

属性值

Boolean

如果服务器控件保持其视图状态，则否 true；否则为 false。 默认值为 true。

属性

ThemeableAttribute

示例

以下示例将 EnableViewState 属性设置为 false。

void Page_Load(object sender, System.EventArgs e)
{
      DataBind();
      // Set EnableViewState to false to disable saving of view state 
      // information.
      myControl.EnableViewState = false;
      if (!IsPostBack)
         display.Enabled = 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

注解

视图状态使服务器控件能够跨 HTTP 请求保持其状态。 如果满足以下所有条件，则启用控件的视图状态：

• EnableViewState页面的 属性设置为 true。

• 控件 EnableViewState 的 属性设置为 true。

• 控件 ViewStateMode 的 属性设置为 Enabled 或继承 Enabled 设置。

有关更多信息，请参见 ViewStateMode 属性。

服务器控件的视图状态是其所有属性值的累积。 为了跨 HTTP 请求保留这些值，ASP.NET 使用 类的 StateBag 实例来存储属性值。 然后，在处理后续请求时，这些值将作为变量传递给隐藏字段。 有关视图状态的详细信息，请参阅 ASP.NET 视图状态概述。

有时，禁用视图状态是合适的，尤其是为了提高应用程序性能。 例如，如果要将数据库请求加载到服务器控件中，请将此属性设置为 false。 否则，处理器时间将浪费，将视图状态加载到服务器控件中，该状态将仅由数据库查询覆盖。 如果 EnableViewState 为 false，则可以使用控件状态来保存特定于控件的属性信息，并且不能像视图状态属性一样关闭。 有关控件状态与视图状态之间的差异的详细信息，请参阅 控件状态与视图状态示例。

有关如何以声明方式为 ASP.NET 页面启用或禁用视图状态的信息，请参阅 @ Page。

另请参阅

• ViewStateMode
• ViewState
• LoadViewState(Object)
• SaveViewState()
• IsViewStateEnabled
• ASP.NET 页生命周期简介
• ASP.NET 状态管理概述
• 控制状态与视图状态示例