Control.IsTrackingViewState プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.IsTrackingViewState プロパティ

サーバーコントロールがビューステートの変更を保存しているかどうかを示す値を取得します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected ReadOnly Property
 IsTrackingViewState As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = Me.IsTrackingViewState

protected bool IsTrackingViewState { get;
 }

C++

protected:
property bool IsTrackingViewState {
    bool get ();
}

/** @property */
protected boolean get_IsTrackingViewState ()

JScript

protected function get IsTrackingViewState
 () : boolean

プロパティ値
コントロールがその状態を保存するようにマークされている場合は true。それ以外の場合は false。

解説

このプロパティを使用するカスタムサーバーコントロールの例については、「テンプレートサーバーコントロールの例」を参照してください。

使用例

カスタム ASP.NET サーバーコントロールの DataBind メソッドをオーバーライドする例を次に示します。まず、基本 OnDataBinding メソッドを呼び出して ControlCollection を使用します。そして、ControlCollection.Clear メソッドですべての子コントロールを削除し、ClearChildViewState メソッドでこれらの子コントロールの保存されたビューステート設定を削除します。最後に、ChildControlsCreated プロパティが true に設定されます。その後、コントロールは IsTrackingViewState プロパティを使用して、そのコントロールのビューステートの変化の追跡が有効かどうかを確認します。有効になっていない場合は、TrackViewState メソッドが呼び出されます。

Visual Basic

Public Overrides Sub DataBind()
   MyBase.OnDataBinding(EventArgs.Empty)
   ' Reset the control's state.
   Controls.Clear()
   ' Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   If HasChildViewState Then
      ClearChildViewState()
   End If
   ChildControlsCreated = True
   If Not IsTrackingViewState Then
      TrackViewState()
   End If
End Sub

public override void DataBind() 
{
   base.OnDataBinding(EventArgs.Empty);
   // Reset the control's state.
   Controls.Clear();
   // Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   if (HasChildViewState)
      ClearChildViewState();
   ChildControlsCreated = true;
   if (!IsTrackingViewState)
      TrackViewState();
}

public void DataBind()
{
    super.OnDataBinding(EventArgs.Empty);

    // Reset the control's state.
    get_Controls().Clear();

    // Check for HasChildViewState to avoid unnecessary calls to 
    // ClearChildViewState.
    if (get_HasChildViewState()) {
        ClearChildViewState();
    }
    set_ChildControlsCreated(true);
    if (!(get_IsTrackingViewState())) {
        TrackViewState();
    }
} //DataBind