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 控件添加到页面。

• 将 TargetControlIDQueryExtender 控件的 属性设置为目标数据源控件的 ID。

• 将 ControlFilterExpression 实例添加到 QueryExtender 控件。

• 将 ControlID 元素的 ControlFilterExpression 属性设置为源数据绑定控件。

构造函数

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)

另请参阅

• QueryableFilterRepeater
• DynamicFilter
• QueryExtender
• Column