DynamicFilterExpression 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
透過指定篩選器控制中的值來修改資料庫查詢。
public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpressionpublic class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpressiontype DynamicFilterExpression = class
inherit DataSourceExpressionPublic Class DynamicFilterExpression
Inherits DataSourceExpression- 繼承
範例
以下範例展示了如何使用 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為參考篩選器控制。
在前述步驟中，假設相關的過濾控制、資料綁定控制與資料來源控制已在頁面中定義。
建構函式
| 名稱 | Description |
|---|---|
| DynamicFilterExpression() |
初始化 DynamicFilterExpression 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| Context |
擁有 HttpContext 者實例控制權。 (繼承來源 DataSourceExpression) |
| ControlID |
取得或設定過濾器控制識別碼。 |
| DataSource |
取得與擁有者控制權相關聯的資料來源物件。 (繼承來源 DataSourceExpression) |
| IsTrackingViewState |
會取得一個值，表示資料來源的表達式物件是否正在追蹤其檢視狀態的變化。 (繼承來源 DataSourceExpression) |
| Owner |
這樣就能取得主人的控制權。 (繼承來源 DataSourceExpression) |
| ViewState |
取得包含當前視圖狀態資訊的 StateBag 類別實例。 (繼承來源 DataSourceExpression) |
方法
| 名稱 | Description |
|---|---|
| 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) |
明確介面實作
| 名稱 | Description |
|---|---|
| IStateManager.IsTrackingViewState |
當由類別實作時，會獲得一個值，指示資料來源表達式物件是否正在追蹤其檢視狀態的變化。 (繼承來源 DataSourceExpression) |
| IStateManager.LoadViewState(Object) |
當類別實作時，會載入先前儲存的資料來源表達式物件的檢視狀態。 (繼承來源 DataSourceExpression) |
| IStateManager.SaveViewState() |
當由類別實作時，會儲存物件目前的檢視狀態 DataSourceExpression 。 (繼承來源 DataSourceExpression) |
| IStateManager.TrackViewState() |
當類別實作時，會追蹤物件的 DataSourceExpression 視圖狀態變化，使變更能儲存在 StateBag 資料來源表達式物件的物件中。 (繼承來源 DataSourceExpression) |
