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 State Management の概要
• コントロールの状態とビューの状態の例