DynamicFilter Klass

Definition

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

Arv

Object

Control

DynamicFilter

Implementeringar

IFilterExpressionProvider

Exempel

I följande exempel används standardfiltermallen ForeignKey.ascx för att skapa användargränssnittet för filtrering av produkttabellrader efter kolumnen ProductCategory foreign-key. När användaren väljer ett ProductCategory-värde visas endast de rader som innehåller det värdet.

Exemplet kräver följande:

• En webbplats för dynamiska data eller ett webbprogram för dynamiska data. På så sätt kan du skapa AdventureWorksLTDataContext datakontexten för databasen och skapa de klasser som tabellerna ska komma åt. Mer information finns i 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

Kommentarer

I den här artikeln:

• Inledning
• ClassContext
• Deklarativ syntax

Introduction

Kontrollen DynamicFilter används i en sidmarkering för att generera användargränssnittet för filtrering av tabellrader. Dynamiska data skapar användargränssnittet med hjälp av standardfiltermallarna som finns i mappen ~\DynamicData\Filters. Dessa mallar har stöd för kolumntyperna sekundärnyckel, boolesk och uppräkning.

I följande tabell visas några av de uppgifter som du kan utföra.

Du kan ange den filtermall som ska användas på följande sätt:

• Genom att använda egenskapen FilterUIHint i sidmarkering. Den här metoden är en anpassning av presentationsskiktet, som är oberoende av schemat (databasen) och som gäller för en enda sida.
• Genom att FilterUIHintAttribute använda attributet i modellen. Den här metoden är en anpassning på datanivå som beror på det specifika schemat (databasen) och som gäller för hela programmet.

Om du använder båda metoderna har filtermallen som anges i markering företräde framför mallen som anges i datamodellen.

Klasskontext

Kontrollen DynamicFilter är utformad för att fungera med QueryExtender kontrollen. Kontrollen DynamicFilter refereras av en DynamicFilterExpression instans i ett QueryExtender objekt i sidmarkeringen.

Följande bild visar de steg som dynamiska data följer för att implementera tabellradfiltrering efter en sekundärnyckelkolumn.

1. Kontrollen DynamicFilter skickar det valda värdet till QueryExtender kontrollen.
2. Kontrollen QueryExtender använder värdet för att skapa information om frågefiltrering. Den skickar sedan den här informationen till datakällans kontroll.
3. Datakällans kontroll skickar filtreringsfrågainformationen till datakällans provider.
4. Datakällans provider skickar frågan till databasen.
5. Databasen returnerar de filtrerade tabellraderna.
6. Datakällans provider skickar dessa data tillbaka till datakällans kontroll.
7. Datakällans kontroll skickar de filtrerade tabellraderna till den databundna kontrollen för visning.

Deklarativ syntax

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

Se även

• QueryableFilterRepeater
• Genomgång: Filtrera rader i tabeller med en Parent-Child relation