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 데이터에서 Products 테이블의 ProductName 및 Supplier.CompanyName 열에서 LinqDataSource 콘텐츠를 검색 합니다. 개체는 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 및 컨트롤에 TextBoxFrom 입력된 값을 사용하여 컨트롤에서 반환되는 데이터에서 Products 테이블의 ProductName 및 Supplier.CompanyName 열에서 LinqDataSourceTextBoxTo 값을 검색합니다. 요소는 ControlParameter 범위를 검색하는 데 사용할 최소값과 최대값을 포함하는 텍스트 상자 컨트롤을 지정합니다. 및 MaxType 속성은 MinType 반환되는 데이터에 최소값과 최대값을 포함해야 함을 지정합니다. 이 코드 예제는에서 제공 하는 더 큰 예제의 일부입니다 연습: 웹 페이지를 사용 하 여 선언적 구문으로 데이터 필터링합니다.

<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 것보다 더 풍부한 필터링 환경을 제공합니다. 예를 들어 쿼리를 작성하지 않고 필터를 사용하여 PropertyExpression Products 테이블에서 부울 값을 검색할 수 있습니다.

• 및 컨트롤 및 EntityDataSource 사용할 수 있는 다른 데이터 원본 컨트롤에 대해 동일한 구문을 LinqDataSource 사용하여 필터를 지정할 수 있습니다.

• 컨트롤, 컨트롤 또는 타사 데이터 원본과 함께 EntityDataSource 사용할 LinqDataSource 수 있습니다.

필터 옵션

QueryExtender 컨트롤은 다양 한 데이터를 필터링 하는 데 사용할 수 있는 옵션을 지원 합니다. 컨트롤을 사용하면 문자열을 검색하고, 지정된 범위에서 숫자 값을 검색하고, 테이블의 속성 값을 지정된 값과 비교할 수 있습니다. 또한 컨트롤을 사용하면 데이터를 정렬하고 사용자 지정 쿼리를 제공할 수 있습니다.

LINQ 식으로 이러한 옵션은 제공 된 QueryExtender 컨트롤입니다. 또한 컨트롤은 QueryExtender ASP.NET 동적 데이터 애플리케이션과 관련된 식을 지원합니다.

다음 표에서는 컨트롤의 데이터를 필터링하는 데 사용할 수 있는 옵션을 나열합니다 QueryExtender .

이러한 QueryExtender 옵션을 개별적으로 사용하거나 결합하여 웹 페이지에서 복잡한 필터링을 제공할 수 있습니다. 자세한 내용은 QueryExtender 웹 서버 컨트롤 개요를 참조하세요. 연습: 선언적 구문을 사용하여 웹 페이지에서 데이터 필터링

작업

다음 표에는 컨트롤을 사용하여 데이터를 필터링하는 방법을 보여 주는 태스크가 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