ControlFilterExpression 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用資料繫結控制項中選取的項目資料索引鍵來修改資料庫查詢。
public ref class ControlFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpressionpublic class ControlFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpressiontype ControlFilterExpression = class
inherit DataSourceExpressionPublic Class ControlFilterExpression
Inherits DataSourceExpression- 繼承
範例
下列範例示範如何使用 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) |