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 して Web ページで検索機能を提供する方法を示しています。 コントロールは QueryExtender 、コントロールに入力されたテキストを TextBoxSearch 使用して、コントロールから返されるデータ内の Products テーブルの ProductName 列および Supplier.CompanyName 列の内容を LinqDataSource 検索します。 オブジェクトは SearchExpression 、検索を実行するために使用されます。 プロパティは DataFields 、検索するデータ フィールドを指定します。 プロパティは SearchType 、実行する検索の種類を指定します。 要素は ControlParameter 、検索に使用するテキストを含むコントロールを指定します。 このコード例は、「 チュートリアル: 宣言構文を使用した Web ページのデータのフィルター処理」で提供されている大きな例の一部です。

<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 使用して、指定された範囲内の値を Web ページで検索する方法を示しています。 コントロールはQueryExtender、 コントロールおよび TextBoxTo コントロールにTextBoxFrom入力された値を使用して、コントロールから返されるデータ内の Products テーブルの ProductName 列と Supplier.CompanyName 列の値をLinqDataSource検索します。 要素は ControlParameter 、範囲の検索に使用する最小値と最大値を含むテキスト ボックス コントロールを指定します。 プロパティと MaxType プロパティはMinType、返されるデータに最小値と最大値を含めなければならないことを指定します。 このコード例は、「 チュートリアル: 宣言構文を使用した Web ページのデータのフィルター処理」で提供されるより大きな例の一部です。

<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を使用してフィルターを指定できます。

• コントロール、コントロール、EntityDataSourceまたはサードパーティのデータ ソースで使用LinqDataSourceできます。

フィルター オプション

コントロールでは QueryExtender 、データのフィルター処理に使用できるさまざまなオプションがサポートされています。 コントロールを使用すると、文字列を検索したり、指定した範囲内の数値を検索したり、テーブル内のプロパティ値を指定した値と比較したりできます。 コントロールを使用すると、データを並べ替えたり、カスタム クエリを提供したりすることもできます。

これらのオプションは、コントロールの QueryExtender LINQ 式として提供されます。 コントロールは QueryExtender 、動的データ アプリケーションに固有の式 ASP.NET サポートしています。

次の表に、コントロール内のデータをフィルター処理するために使用できるオプションを QueryExtender 示します。

これらの QueryExtender オプションは個別に使用することも、組み合わせて Web ページで複雑なフィルター処理を提供することもできます。 詳細については、「 QueryExtender Web サーバー コントロールの概要」を参照してください。 チュートリアル: 宣言構文を使用して 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