DynamicFilterExpression 類別

定義

命名空間:

System.Web.DynamicData

組件:

System.Web.DynamicData.dll

使用指定的篩選器控制項中的值來修改資料庫查詢。

public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression

public class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression

type DynamicFilterExpression = class
    inherit DataSourceExpression

Public Class DynamicFilterExpression
Inherits DataSourceExpression

繼承

Object

DataSourceExpression

DynamicFilterExpression

範例

下列範例顯示如何使用 DynamicFilterExpression 控制項，在頁面中選取篩選範本。 篩選範本是由 DynamicFilter DynamicFilterExpression 控制項透過其屬性所識別的控制項所選取 ControlID 。

<asp:QueryExtender ID="QueryExtender1"   
    TargetControlID="GridDataSource" runat="server">  
    <asp:DynamicFilterExpression ControlID="CategoryFilterID" />  
</asp:QueryExtender>  

備註

DynamicFilterExpression類別可讓您使用在控制項中指派的值來修改資料庫查詢 DynamicFilter 。 此控制項會將建立查詢的工作委派 IQueryable 給特製化控制項，例如 QueryableFilterRepeater 控制項或 DynamicFilter 控制項。

接著，篩選控制項會將查詢的建立委派給它們所參考的篩選範本。 然後查詢會由控制項參考的資料來源控制項執行 QueryExtender 。

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

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

• 將 TargetControlID 控制項的屬性設定 QueryExtender 為參考資料源控制項。

• 將 DynamicFilterExpression 物件新增為控制項的子系 QueryExtender 。

• 將 ControlID 物件的屬性設定 DynamicFilterExpression 為參考篩選控制項。

在先前的步驟中，假設相關的篩選控制項、資料繫結控制項，以及資料來源控制項都定義于頁面中。

建構函式

DynamicFilterExpression()

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

屬性

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)	載入 DataSourceExpression 物件中必須保存的值狀態。 (繼承來源 DataSourceExpression)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SaveViewState()	儲存 DataSourceExpression 物件的目前檢視狀態。 (繼承來源 DataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource)	使用資料來源資訊初始化運算式。
SetDirty()	標記 DataSourceExpression 物件，以便將其狀態儲存在檢視狀態中。 (繼承來源 DataSourceExpression)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TrackViewState()	追蹤 DataSourceExpression 物件的檢視狀態變更，以便該變更可針對資料來源運算式物件儲存到 StateBag 物件中。 (繼承來源 DataSourceExpression)

明確介面實作

IStateManager.IsTrackingViewState	當由類別實作時取得值，這個值指出資料來源運算式物件是否正在追蹤其檢視狀態變更。 (繼承來源 DataSourceExpression)
IStateManager.LoadViewState(Object)	當由類別實作時，載入資料來源運算式物件先前儲存的檢視狀態。 (繼承來源 DataSourceExpression)
IStateManager.SaveViewState()	當類別實作時，儲存 DataSourceExpression 物件的目前檢視狀態。 (繼承來源 DataSourceExpression)
IStateManager.TrackViewState()	當由類別實作時，追蹤 DataSourceExpression 物件的檢視狀態變更，以便該變更可針對資料來源運算式物件儲存到 StateBag 物件中。 (繼承來源 DataSourceExpression)

另請參閱

• QueryableFilterRepeater
• DynamicFilter
• QueryExtender