Control.EnableViewState プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要求元クライアントに対して、サーバー コントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。
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 要求全体でその状態を維持できます。 コントロールの表示状態は、次のすべての条件が満たされた場合に有効になります。
EnableViewStateページの プロパティは に
true
設定されます。EnableViewStateコントロールの プロパティが に
true
設定されています。ViewStateModeコントロールの プロパティが にEnabled設定されているか、設定をEnabled継承します。
詳細については、ViewStateMode プロパティを参照してください。
サーバー コントロールのビューステートは、そのすべてのプロパティ値の累積です。 HTTP 要求全体でこれらの値を保持するために、ASP.NET は クラスのインスタンスを StateBag 使用してプロパティ値を格納します。 その後、後続の要求が処理されると、値は変数として非表示フィールドに渡されます。 ビュー ステートの詳細については、「ASP.NET ビュー ステートの概要」を参照してください。
特にアプリケーションのパフォーマンスを向上させるために、ビューステートを無効にすることが適切な場合があります。 たとえば、データベース要求をサーバー コントロールに読み込む場合は、このプロパティを に設定します false
。 そうでない場合、プロセッサ時間は、データベース クエリによってのみオーバーライドされるサーバー コントロールへのビュー ステートの読み込みが無駄になります。 が false
の場合EnableViewState、コントロールの状態を使用して、コントロールに固有のプロパティ情報を保持でき、ビュー ステート プロパティのようにオフにすることはできません。 コントロールステートとビューステートの違いの詳細については、「 コントロールステートとビューステートの例」を参照してください。
ASP.NET ページの表示状態を宣言的に有効または無効にする方法については、「 @Page」を参照してください。
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示