ControlFilterExpression クラス

定義

データ バインド コントロールで選択されている項目のデータ キーを使用して、データベース クエリを変更します。

public ref class ControlFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression
public class ControlFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression
type ControlFilterExpression = class
    inherit DataSourceExpression
Public Class ControlFilterExpression
Inherits DataSourceExpression
継承
ControlFilterExpression

次の例は、 ControlFilterExpression クラスを使用して、データ キーが選択されているソース データ バインド コントロールを参照する方法を示しています。 QueryExtender コントロールは、選択したデータ キーを使用してフィルター処理されたデータを取得するターゲット データ ソース コントロールを指します。 この例では、ソース データ バインド コントロールが親テーブルを参照し、ターゲット データ バインド コントロールが子テーブルを参照しています。

<asp:QueryExtender ID="QueryExtenderID"
    TargetControlID="TargetDataSourceID" runat="server">
    <asp:ControlFilterExpression ControlID="SourceGridViewID" />
</asp:QueryExtender>

注釈

ページに 2 つのデータ バインド コントロール (GridView コントロールやListView コントロールなど) が含まれている場合に使用するように設計されたControlFilterExpression クラス。 1 つのコントロールは、データ キー (行) が選択されているソースです。 もう 1 つのコントロールは、選択したデータ キーに基づいてデータが表示されるターゲットです。 ターゲット データは、 QueryExtender クラスで定義され、選択したデータ キーを使用して構築されたクエリを実行するデータ ソース コントロールによって取得されます。

ページで ControlFilterExpression クラスを使用するには、次の手順に従います。

  • QueryExtender コントロールをページに追加します。

  • QueryExtender コントロールの TargetControlID プロパティをターゲット データ ソース コントロールの ID に設定します。

  • QueryExtender コントロールにControlFilterExpression インスタンスを追加します。

  • ControlFilterExpression要素のControlID プロパティをソース データ バインド コントロールに設定します。

コンストラクター

名前 説明
ControlFilterExpression()

ControlFilterExpression クラスの新しいインスタンスを初期化します。

プロパティ

名前 説明
Column

クエリの基になる列の名前を取得または設定します。

Context

所有者コントロールの HttpContext インスタンスを取得します。

(継承元 DataSourceExpression)
ControlID

ソース データ バインド コントロールの ID を取得または設定します。

DataSource

所有者コントロールに関連付けられているデータ ソース オブジェクトを取得します。

(継承元 DataSourceExpression)
IsTrackingViewState

データ ソース式オブジェクトがビュー ステートの変更を追跡しているかどうかを示す値を取得します。

(継承元 DataSourceExpression)
Owner

所有者コントロールを取得します。

(継承元 DataSourceExpression)
ViewState

現在のビューステート情報を含む StateBag クラスのインスタンスを取得します。

(継承元 DataSourceExpression)

メソッド

名前 説明
Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetQueryable(IQueryable)

変更するデータ ソース クエリを取得します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
LoadViewState(Object)

以前に保存したビューステートを復元します。

MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
SaveViewState()

ページがサーバーに投稿された時刻以降の表示状態の変更を保存します。

SetContext(Control, HttpContext, IQueryableDataSource)

データ ソース情報を使用してフィルター式を初期化します。

SetDirty()

DataSourceExpression オブジェクトの状態がビュー ステートに保存されるようにマークします。

(継承元 DataSourceExpression)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TrackViewState()

ControlFilterExpression オブジェクトがビューステートの変更を追跡し、コントロールのビュー ステート オブジェクトに格納し、同じページに対する要求間で保持できるようにします。

明示的なインターフェイスの実装

名前 説明
IStateManager.IsTrackingViewState

クラスによって実装された場合、データ ソース式オブジェクトがビュー ステートの変更を追跡しているかどうかを示す値を取得します。

(継承元 DataSourceExpression)
IStateManager.LoadViewState(Object)

クラスによって実装された場合は、以前に保存したデータ ソース式オブジェクトのビュー ステートを読み込みます。

(継承元 DataSourceExpression)
IStateManager.SaveViewState()

クラスによって実装された場合は、 DataSourceExpression オブジェクトの現在のビューステートを保存します。

(継承元 DataSourceExpression)
IStateManager.TrackViewState()

クラスによって実装された場合、データ ソース式オブジェクトのDataSourceExpression オブジェクトに変更を格納できるように、StateBag オブジェクトのビュー ステートの変更を追跡します。

(継承元 DataSourceExpression)

適用対象

こちらもご覧ください