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 です。

属性

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。 そうでない場合、プロセッサ時間は、データベース クエリによってのみオーバーライドされるサーバー コントロールへのビュー ステートの読み込みが無駄になります。 が falseの場合EnableViewState、コントロールの状態を使用して、コントロールに固有のプロパティ情報を保持でき、ビュー ステート プロパティのようにオフにすることはできません。 コントロールステートとビューステートの違いの詳細については、「 コントロールステートとビューステートの例」を参照してください。

ASP.NET ページの表示状態を宣言的に有効または無効にする方法については、「 @Page」を参照してください。

適用対象

こちらもご覧ください

• ViewStateMode
• ViewState
• LoadViewState(Object)
• SaveViewState()
• IsViewStateEnabled
• ASP.NET ページのライフ サイクルの概要
• ASP.NET 状態管理の概要
• コントロールの状態とビューステートの例