DynamicFilter Classe

Définition

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

public ref class DynamicFilter : System::Web::UI::Control, System::Web::DynamicData::IFilterExpressionProvider

public class DynamicFilter : System.Web.UI.Control

public class DynamicFilter : System.Web.UI.Control, System.Web.DynamicData.IFilterExpressionProvider

type DynamicFilter = class
    inherit Control

type DynamicFilter = class
    inherit Control
    interface IFilterExpressionProvider

Public Class DynamicFilter
Inherits Control

Public Class DynamicFilter
Inherits Control
Implements IFilterExpressionProvider

Héritage

Object

Control

DynamicFilter

Implémente

IFilterExpressionProvider

Exemples

Un projet Visual Studio avec du code source est disponible à cet emplacement : Télécharger.

Les exemples suivants utilisent le modèle de filtre ForeignKey.ascx par défaut pour créer l’interface utilisateur permettant de filtrer les lignes de la table Products par la colonne clé étrangère ProductCategory. Lorsque l’utilisateur sélectionne une valeur ProductCategory, seules les lignes qui contiennent cette valeur sont affichées.

L’exemple nécessite les éléments suivants :

• Un site web de données dynamiques ou une application web de données dynamiques. Cela vous permet de créer le AdventureWorksLTDataContext contexte de données pour la base de données et de créer les classes accessibles aux tables. Pour plus d'informations, consultez Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

<%@ Page Language="C#" MasterPageFile="~/Site.master" 
    CodeFile="DynamicFilter.aspx.cs" Inherits="ForeignKeyFilter" %>

<%@ Register src="~/DynamicData/Content/GridViewPager.ascx" tagname="GridViewPager" tagprefix="asp" %>

<asp:Content ID="headContent" ContentPlaceHolderID="head" Runat="Server">
</asp:Content>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">

    <asp:DynamicDataManager ID="DynamicDataManager1" runat="server" AutoLoadForeignKeys="true" />

    <h2 class="DDSubHeader"><%= table.DisplayName%> ForeignKey filter</h2>

    <asp:UpdatePanel ID="UpdatePanel1" runat="server">
        <ContentTemplate>
            <asp:ValidationSummary ID="ValidationSummary1" runat="server" 
                EnableClientScript="true"
                HeaderText="List of validation errors" />
            <asp:DynamicValidator runat="server" ID="GridViewValidator" 
                ControlToValidate="GridView1" Display="None" />
            
            <!-- Show that the filter selection 
                is retained after a post-back -->
            <asp:Button ID="Button1" runat="server" Text="Cause Postback" />    
            <span></span>The filter selection is retained after a postback.</span> 
         
            <br />
            
            <!-- Set the DynamicFilter control attributes. --> 
            Select Category: <asp:DynamicFilter runat="server" ID="CategoryFilter" 
            DataField="ProductCategory" FilterUIHint="ForeignKey" 
            OnFilterChanged="OnFilterSelectedIndexChanged" /><br />

            <!-- Data-bound control that shows the filtered table rows. -->
            <asp:GridView ID="GridView1" runat="server" DataSourceID="GridDataSource" 
                EnablePersistedSelection="true" PageSize="5" 
                AllowPaging="True" AllowSorting="True" CssClass="DDGridView">
                <Columns>
                    <asp:TemplateField>
                        <ItemTemplate>
                            <asp:LinkButton ID="DeleteLinkButton" runat="server" CommandName="Delete"
                                CausesValidation="true" Text="Delete"
                                OnClientClick='return confirm("Are you sure you want to delete this item?");'
                            />
                        </ItemTemplate>
                    </asp:TemplateField>
                </Columns>

                <PagerStyle CssClass="footer"/>        
                <PagerTemplate>
                    <asp:GridViewPager runat="server" />
                </PagerTemplate>
                <EmptyDataTemplate>
                    There are currently no items in this table.
                </EmptyDataTemplate>
            </asp:GridView>
            
            <!-- The provider that connects to the database -->
            <asp:LinqDataSource ID="GridDataSource" runat="server" 
                EnableDelete="true" 
                ContextTypeName="AdventureWorksLTDataContext"
                TableName="Products">
            </asp:LinqDataSource>
            
            <!-- The control that handles the details for querying 
            the database, after a user's filtering action -->
            <asp:QueryExtender ID="QueryBlock1" TargetControlID="GridDataSource" 
                runat="server">
                <asp:DynamicFilterExpression ControlID="CategoryFilter" />
            </asp:QueryExtender>
            
        </ContentTemplate>
    </asp:UpdatePanel>
 
</asp:Content>

<%@ Page Language="VB" MasterPageFile="~/Site.master" 
AutoEventWireup="true" CodeFile="DynamicFilter.aspx.vb" 
Inherits="ForeignKeyFilter" %>

<%@ Register src="~/DynamicData/Content/GridViewPager.ascx" tagname="GridViewPager" tagprefix="asp" %>

<asp:Content ID="headContent" ContentPlaceHolderID="head" Runat="Server">
</asp:Content>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">

    <asp:DynamicDataManager ID="DynamicDataManager1" runat="server" AutoLoadForeignKeys="true" />

    <h2 class="DDSubHeader"><%= table.DisplayName%> ForeignKey filter</h2>

    <asp:UpdatePanel ID="UpdatePanel1" runat="server">
        <ContentTemplate>
            <asp:ValidationSummary ID="ValidationSummary1" runat="server" 
                EnableClientScript="true"
                HeaderText="List of validation errors" />
            <asp:DynamicValidator runat="server" ID="GridViewValidator" 
                ControlToValidate="GridView1" Display="None" />
            
            <!-- Show that the filter selection 
                is retained after a post-back -->
            <asp:Button ID="Button1" runat="server" Text="Cause Postback" />    
            <span></span>The filter selection is retained after a postback.</span> 
         
            <br />
            
            <!-- Set the DynamicFilter control attributes. --> 
            Select Category: <asp:DynamicFilter runat="server" ID="CategoryFilter" 
            DataField="ProductCategory" FilterUIHint="ForeignKey" 
            OnFilterChanged="OnFilterSelectedIndexChanged" /><br />

            <!-- Data-bound control that shows the filtered table rows. -->
            <asp:GridView ID="GridView1" runat="server" DataSourceID="GridDataSource" 
                EnablePersistedSelection="true" PageSize="5" 
                AllowPaging="True" AllowSorting="True" CssClass="DDGridView">
                <Columns>
                    <asp:TemplateField>
                        <ItemTemplate>
                            <asp:LinkButton ID="DeleteLinkButton" runat="server" CommandName="Delete"
                                CausesValidation="true" Text="Delete"
                                OnClientClick='return confirm("Are you sure you want to delete this item?");'
                            />
                        </ItemTemplate>
                    </asp:TemplateField>
                </Columns>

                <PagerStyle CssClass="footer"/>        
                <PagerTemplate>
                    <asp:GridViewPager ID="GridViewPager1" runat="server" />
                </PagerTemplate>
                <EmptyDataTemplate>
                    There are currently no items in this table.
                </EmptyDataTemplate>
            </asp:GridView>
            
            <!-- The provider that connects to the database -->
            <asp:LinqDataSource ID="GridDataSource" runat="server" 
                EnableDelete="true" 
                ContextTypeName="AdventureWorksLTDataContext"
                TableName="Products">
            </asp:LinqDataSource>
            
            <!-- The control that handles the details for querying 
            the database, after a user's filtering action -->
            <asp:QueryExtender ID="QueryBlock1" TargetControlID="GridDataSource" 
                runat="server">
                <asp:DynamicFilterExpression ControlID="CategoryFilter" />
            </asp:QueryExtender>
            
        </ContentTemplate>
    </asp:UpdatePanel>
 
</asp:Content>

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.Xml.Linq;
using System.Web.DynamicData;

    public partial class ForeignKeyFilter : System.Web.UI.Page {
        protected MetaTable table;

        protected void Page_Init(object sender, EventArgs e) {
            DynamicDataManager1.RegisterControl(GridView1, 
                true /* setSelectionFromUrl */);
        }

        protected void Page_Load(object sender, EventArgs e) {
            table = GridDataSource.GetTable();
            Title = table.DisplayName;

            // Disable various options if the table is readonly
            if (table.IsReadOnly) {
                GridView1.Columns[0].Visible = false;
            }
        }

        // Handle the filter change event.
        protected void OnFilterSelectedIndexChanged(object sender, EventArgs e) {
            // Reset the index of the page to display after 
            // the data filter value has been changed.
            GridView1.PageIndex = 0;
        }
    }

Imports System.Data
Imports System.Configuration
Imports System.Collections
Imports System.Linq
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls
Imports System.Xml.Linq
Imports System.Web.DynamicData


Partial Public Class ForeignKeyFilter
    Inherits System.Web.UI.Page
    Protected table As MetaTable

    Protected Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
        'setSelectionFromUrl
        DynamicDataManager1.RegisterControl(GridView1, True)
    End Sub

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        table = GridDataSource.GetTable()
        Title = table.DisplayName

        ' Disable various options if the table is readonly
        If table.IsReadOnly Then
            GridView1.Columns(0).Visible = False
        End If
    End Sub

    ' Handle the filter change event.
    Protected Sub OnFilterSelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
        ' Reset the index of the page to display after 
        ' the data filter value has been changed.
        GridView1.PageIndex = 0

    End Sub

End Class

Remarques

Dans cette rubrique :

• Introduction

• ClassContext

• Syntaxe déclarative

Introduction

Le DynamicFilter contrôle est utilisé dans un balisage de page pour générer l’interface utilisateur pour filtrer les lignes de table. Dynamic Data crée l’interface utilisateur à l’aide des modèles de filtre par défaut qui se trouvent dans le dossier ~\DynamicData\Filters. Ces modèles prennent en charge les types de colonnes de clé étrangère, booléenne et d’énumération.

Le tableau suivant présente certaines des tâches que vous pouvez effectuer.

Vous pouvez spécifier le modèle de filtre à utiliser des manières suivantes :

• En utilisant la propriété dans le FilterUIHint balisage de page. Cette approche est une personnalisation de la couche présentation, qui est indépendante du schéma (base de données) et qui s’applique à une seule page.

• En utilisant l’attribut FilterUIHintAttribute dans le modèle. Cette approche est une personnalisation de la couche données, qui dépend du schéma spécifique (base de données) et qui s’applique à l’ensemble de l’application.

Si vous utilisez les deux approches, le modèle de filtre spécifié dans le balisage est prioritaire sur le modèle spécifié dans le modèle de données.

Contexte de classe

Le DynamicFilter contrôle est conçu pour fonctionner avec le QueryExtender contrôle. Le DynamicFilter contrôle est référencé par un DynamicFilterExpression instance à l’intérieur d’un QueryExtender objet dans le balisage de page.

L’illustration suivante montre les étapes suivies par Dynamic Data pour implémenter le filtrage de lignes de table par une colonne de clé étrangère.

1. Le DynamicFilter contrôle transmet la valeur sélectionnée au QueryExtender contrôle.

2. Le QueryExtender contrôle utilise la valeur pour créer les informations de filtrage des requêtes. Il transmet ensuite ces informations au contrôle de source de données.

3. Le contrôle de source de données transmet les informations de requête de filtrage au fournisseur de source de données.

4. Le fournisseur de source de données transmet la requête à la base de données.

5. La base de données retourne les lignes de table filtrées.

6. Le fournisseur de source de données renvoie ces données au contrôle de source de données.

7. Le contrôle de source de données transmet les lignes de table filtrées au contrôle lié aux données pour affichage.

Syntaxe déclarative

<asp:DynamicFilter  
    ID="Control ID"  
    DataField="Name of the data field to use for filtering"  
    EnableViewState="True|False"   
    FilterUIHint="Name of the filter template to generate the UI"  
    OnFilterChanged="Filter changed event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="Unload event handler"   
    Visible="True|False"  
    runat="server"/>  

Constructeurs

Propriétés

Méthodes

Événements

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à

Voir aussi

• QueryableFilterRepeater
• Procédure pas à pas : filtrage des lignes dans des tables avec une relation Parent-Child