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 屬性 (Property)。

伺服器控制器的檢視狀態是其所有屬性值的累積。 為了跨 HTTP 要求保留這些值，ASP.NET 使用 類別的 StateBag 實例來儲存屬性值。 然後，當處理後續要求時，這些值會當做變數傳遞至隱藏欄位。 如需檢視狀態的詳細資訊，請參閱 ASP.NET 檢視狀態概觀。

有時適合停用檢視狀態，特別是為了改善應用程式效能。 例如，如果您要將資料庫要求載入伺服器控制項，請將此屬性設定為 false。 如果您沒有這麼做，處理器時間將會浪費在伺服器控制項中，而該伺服器控制項只會由資料庫查詢覆寫。 如果 EnableViewState 為 false，您可以使用控件狀態來保存控制件特有的屬性資訊，而且無法關閉，就像檢視狀態屬性一樣。 如需控件狀態與檢視狀態差異的詳細資訊，請參閱 控件狀態與檢視狀態範例。

如需如何針對 ASP.NET 頁面以宣告方式啟用或停用檢視狀態的資訊，請參閱 @ Page。

另請參閱

• ViewStateMode
• ViewState
• LoadViewState(Object)
• SaveViewState()
• IsViewStateEnabled
• ASP.NET 頁面生命周期簡介
• ASP.NET 狀態管理概觀
• 控件狀態與檢視狀態範例