ControlFilterExpression 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用数据绑定控件中选择的项的数据键修改数据库查询。
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
- 继承
示例
以下示例演示如何使用 ControlFilterExpression 类引用源数据绑定控件,其中选择了数据键。 该 QueryExtender 控件指向目标数据源控件,该控件使用所选数据键获取筛选的数据。 在此示例中,源数据绑定控件引用父表,目标数据绑定控件引用子表。
<asp:QueryExtender ID="QueryExtenderID"
TargetControlID="TargetDataSourceID" runat="server">
<asp:ControlFilterExpression ControlID="SourceGridViewID" />
</asp:QueryExtender>
注解
当 ControlFilterExpression 页面包含两个 GridView 数据绑定控件(如控件和 ListView 控件)时要使用的类。 一个控件是源,其中选择了数据键(行)。 另一个控件是基于所选数据键显示数据的目标。 目标数据由数据源控件获取,该控件执行在类中 QueryExtender 定义的查询,并使用所选数据键生成。
若要在页面中使用该 ControlFilterExpression 类,请执行以下步骤:
将 QueryExtender 控件添加到页面。
将
TargetControlID控件的属性 QueryExtender 设置为目标数据源控件的 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) |