QueryExtender 类

定义

public ref class QueryExtender : System::Web::UI::Control

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.QueryExtender), "QueryExtender.bmp")]
public class QueryExtender : System.Web.UI.Control

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.QueryExtender), "QueryExtender.bmp")>]
type QueryExtender = class
    inherit Control

Public Class QueryExtender
Inherits Control

继承

Object

Control

QueryExtender

属性

ToolboxBitmapAttribute

示例

以下示例演示如何使用 QueryExtender 控件在网页中提供搜索功能。 控件 QueryExtender 使用在 控件中 TextBoxSearch 输入的文本在从 LinqDataSource 控件返回的数据中搜索 Products 表的 ProductName 和 Supplier.CompanyName 列中的内容。 对象 SearchExpression 用于执行搜索。 属性 DataFields 指定要搜索的数据字段。 属性 SearchType 指定要执行的搜索的类型。 元素 ControlParameter 指定包含要用于搜索的文本的控件。 此代码示例是 演练：使用声明性语法筛选网页中的数据中提供的更大示例的一部分。

<asp:LinqDataSource ID="dataSource" runat="server"   
    TableName="Products">  
</asp:LinqDataSource>  
<asp:QueryExtender TargetControlID="dataSource" runat="server">  
  <asp:SearchExpression DataFields="ProductName, Supplier.CompanyName"   
        SearchType="StartsWith">  
    <asp:ControlParameter ControlID="TextBoxSearch" />  
  </asp:SearchExpression>  
</asp:QueryExtender>  

以下示例演示如何使用 QueryExtender 控件在网页中搜索指定范围内的值。 控件QueryExtender使用 在 和 TextBoxTo 控件中TextBoxFrom输入的值，在从控件返回的数据中搜索 Products 表的 ProductName 和 Supplier.CompanyName 列中的值LinqDataSource。 元素 ControlParameter 指定包含用于搜索范围的最小值和最大值的文本框控件。 MinType和 MaxType 属性指定最小值和最大值必须包含在返回的数据中。 此代码示例是 演练：使用声明性语法筛选网页中的数据中提供的更大示例的一部分。

<asp:LinqDataSource ID="dataSource" runat="server"   
    TableName="Products">  
</asp:LinqDataSource>  
<asp:QueryExtender TargetControlID="dataSource" runat="server">  
  <asp:RangeExpression DataField="UnitPrice" MinType="Inclusive"   
        MaxType="Inclusive">  
    <asp:ControlParameter ControlID="TextBoxFrom" />  
    <asp:ControlParameter ControlID="TexBoxTo" />  
  </asp:RangeExpression>  
</asp:QueryExtender>  

注解

本主题内容：

• 介绍

• 背景

• 筛选器选项

• 任务

• 声明性语法

介绍

控件 QueryExtender 用于为从数据源检索的数据创建筛选器，而无需在数据源中使用显式 Where 子句。 控件 QueryExtender 可用于使用声明性语法指定筛选。

背景

筛选通过仅显示符合指定条件的记录，从数据源中排除数据。 通过筛选，可以显示数据集中数据的不同视图，而不会影响数据集中的数据。

筛选通常要求创建子 Where 句以应用于查询数据源的命令。 但是， Where 数据源控件的 属性可能不会公开可用的完整功能。 例如，使用 QueryExtender 控件，可以通过在 .data 字段中的开头、结尾或任意位置搜索字符串来查询表。

为了公开 LINQ 中提供的完整功能并使筛选数据更容易，ASP.NET 提供了 QueryExtender 控件。 控件 QueryExtender 具有以下优点：

• 它提供比编写 Where 子句更丰富的筛选体验。 例如，可以使用 筛选器在 Products 表中搜索布尔值 PropertyExpression ，而无需编写查询。

• 它允许对 和 EntityDataSource 控件以及可能使用的任何其他数据源控件使用相同的语法LinqDataSource来指定筛选器。

• 它可以与 LinqDataSource 控件、 EntityDataSource 控件或第三方数据源一起使用。

筛选器选项

控件 QueryExtender 支持可用于筛选数据的各种选项。 控件允许搜索字符串、搜索指定范围内的数值，以及将表中的属性值与指定值进行比较。 控件还允许对数据进行排序并提供自定义查询。

这些选项作为 控件中的 QueryExtender LINQ 表达式提供。 控件 QueryExtender 还支持特定于 ASP.NET 动态数据应用程序的表达式。

下表列出了可用于筛选 控件中的数据 QueryExtender 的选项。

可以单独使用这些 QueryExtender 选项，也可以将它们组合在一起，在网页中提供复杂的筛选。 有关详细信息，请参阅 QueryExtender Web 服务器控件概述。 演练：使用声明性语法筛选网页中的数据

任务

下表列出了演示如何使用 QueryExtender 控件筛选数据的任务。

声明性语法

<asp:QueryExtender   
    EnableViewState="True|False"  
    ID="string"  
    OnDataBinding="DataBiding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="UnLoad event handler"  
    Runat="server"  
    TargetControlID="string"  
    Visible="True|False"  
>  
        <asp:ControlFilterExpression   
            ControlD="string"  
            Column="string">   
        </asp:ControlFilterExpression>  
        <asp:DynamicFilterExpression  
            ControlD="string"  
        </asp:DynamicFilterExpression>  
        <asp:CustomExpression="string"  
            OnQuerying="OnQuerying event handler">  
        </asp:CustomExpression>  
        <asp:OrderByExpression="string"  
            DataField="string"  
            Direction="string">  
            <asp:ThenByExpression  
                 DataField="string"  
                 Direction="string"  
            </asp:ThenBy>  
        </asp:OrderByExpression>  
        <asp:PropertyExpression="string">  
                <!-- child controls -->  
        </asp:PropertyExpression  
        >  
        <asp:RangeExpression="integer"  
            Datafield="string"  
            MaxType="Exclusive|Inclusive|None"  
            MinType="Exclusive|Inclusive|None">  
                <!--child controls-->  
        </asp:RangeExpression>  
        <asp:SearchExpression="string"  
            ComparisonType="CurrentCulture|CurrentCultureIgnoreCase|  
                InvariantCulture|InvariantCultureIgnoreCase|  
                Ordinal|OrdinalIgnoreCase"  
            DataField="string"  
            SearchType="Contains|EndsWith|StartsWith">  
                <!--child controls-->  
        </asp:SearchExpression>  
</asp:QueryExtender>  

构造函数

属性

方法

事件

显式接口实现

扩展方法

适用于

另请参阅

• QueryExpression
• ParameterDataSourceExpression
• SearchType