DynamicFilter Klas

Definitie

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

Overname

Object

Control

DynamicFilter

Implementeringen

IFilterExpressionProvider

Voorbeelden

In de volgende voorbeelden wordt de standaardfiltersjabloon ForeignKey.ascx gebruikt om de gebruikersinterface te maken voor het filteren van de tabelrijen Producten op de kolom Met refererende sleutel van ProductCategory. Wanneer de gebruiker een ProductCategory-waarde selecteert, worden alleen de rijen met die waarde weergegeven.

Voor het voorbeeld is het volgende vereist:

• Een dynamische gegevenswebsite of een dynamische gegevenswebtoepassing. Hiermee kunt u de AdventureWorksLTDataContext gegevenscontext voor de database maken en de klassen voor de tabellen maken voor toegang. Zie Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding voor meer informatie.

<%@ 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

Opmerkingen

In dit artikel:

• Introduction
• ClassContext
• Declaratieve syntaxis

Introduction

Het DynamicFilter besturingselement wordt gebruikt in een paginamarkering om de gebruikersinterface te genereren voor het filteren van tabelrijen. Dynamische gegevens maken de gebruikersinterface met behulp van de standaardfiltersjablonen die zich in de map ~\DynamicData\Filters bevinden. Deze sjablonen ondersteunen de kolomtypen refererende sleutels, Booleaanse waarden en opsommingskolomtypen.

In de volgende tabel ziet u enkele taken die u kunt uitvoeren.

U kunt de filtersjabloon opgeven die op de volgende manieren moet worden gebruikt:

• Gebruik de FilterUIHint eigenschap in paginamarkeringen. Deze benadering is een aanpassing van de presentatielaag, die onafhankelijk is van het schema (database) en die van toepassing is op één pagina.
• Door het FilterUIHintAttribute kenmerk in het model te gebruiken. Deze benadering is een aanpassing van de gegevenslaag, die afhankelijk is van het specifieke schema (database) en dat van toepassing is op de hele toepassing.

Als u beide benaderingen gebruikt, heeft de filtersjabloon die is opgegeven in de markering voorrang op de sjabloon die is opgegeven in het gegevensmodel.

Klascontext

Het DynamicFilter besturingselement is ontworpen om met het QueryExtender besturingselement te werken. Er DynamicFilter wordt naar het besturingselement verwezen door een DynamicFilterExpression exemplaar in een QueryExtender object in de paginamarkeringen.

In de volgende afbeelding ziet u de stappen die dynamische gegevens volgen om het filteren van tabelrijen te implementeren op een kolom met refererende sleutels.

1. Het DynamicFilter besturingselement geeft de geselecteerde waarde door aan het QueryExtender besturingselement.
2. Het QueryExtender besturingselement gebruikt de waarde om de filterinformatie voor query's te maken. Vervolgens wordt deze informatie doorgegeven aan het besturingselement voor de gegevensbron.
3. Het besturingselement voor gegevensbronnen geeft de filterquerygegevens door aan de gegevensbronprovider.
4. De gegevensbronprovider geeft de query door aan de database.
5. De database retourneert de gefilterde tabelrijen.
6. De gegevensbronprovider stuurt deze gegevens terug naar het gegevensbronbeheer.
7. Het besturingselement voor gegevensbronnen geeft de gefilterde tabelrijen door aan het gegevensgebonden besturingselement voor weergave.

Declaratieve syntaxis

<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"/>

Zie ook

• QueryableFilterRepeater
• Overzicht: Rijen filteren in tabellen met een Parent-Child-relatie