ControlFilterExpression 類別

定義

命名空間:

System.Web.DynamicData

組件:

System.Web.DynamicData.dll

使用資料繫結控制項中選取的項目資料索引鍵來修改資料庫查詢。

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

繼承

Object

DataSourceExpression

ControlFilterExpression

範例

下列範例示範如何使用 ControlFilterExpression 類別來參考已選取資料索引鍵的源資料繫結控制項。 此 QueryExtender 控制項指向目標資料來源控制項，以取得使用選取的資料索引鍵進行篩選的資料。 在此範例中，源資料繫結控制項會參考父資料表，而目標資料繫結控制項則參考子資料工作表。

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

備註

ControlFilterExpression設計用來在頁面包含兩個資料繫結控制項（例如 GridView 控制項和控制項）時使用的類別 ListView 。 一個控制項是來源，其中選取了資料索引鍵 (資料列) 。 另一個控制項是根據選取的資料索引鍵顯示資料的目標。 目標資料是由執行在類別中定義的查詢，以及使用選取的資料索引鍵所建立之查詢的資料來源控制項所取得 QueryExtender 。

若要 ControlFilterExpression 在頁面中使用類別，請遵循下列步驟：

• 將 QueryExtender 控制項加入至頁面。

• 將 TargetControlID 控制項的屬性設定 QueryExtender 為目標資料來源控制項的識別碼。

• 將 ControlFilterExpression 實例加入至 QueryExtender 控制項。

• 將 ControlID 元素的屬性設定 ControlFilterExpression 為源資料繫結控制項。

建構函式

ControlFilterExpression()

初始化 ControlFilterExpression 類別的新執行個體。

屬性

Column	取得或設定查詢所依據的資料行名稱。
Context	取得擁有者控制項的 HttpContext 執行個體。 (繼承來源 DataSourceExpression)
ControlID	取得或設定來源資料繫結控制項的識別碼。
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)

另請參閱

• QueryableFilterRepeater
• DynamicFilter
• QueryExtender
• Column