Control.EnableViewState 屬性

定義

取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。

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

屬性值

如果伺服器控制項保持其檢視狀態,則為 true;否則為 false。 預設為 true

屬性

範例

下列範例會將 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 屬性 (Property)。

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

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

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

適用於

另請參閱