Control.EnableViewState 属性

  • 参考

定义

命名空间:
System.Web.UI
程序集:
System.Web.dll

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

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };
public virtual bool EnableViewState { get; set; }
[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }
member this.EnableViewState : bool with 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 请求维护其状态。 如果满足以下所有条件，则启用控件的视图状态：

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

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

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

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

适用于

另请参阅