Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe DynamicFilter

.NET Framework (current version)
 

Exibe a interface do usuário para filtrar as linhas da tabela usando uma coluna especificada.

Namespace:   System.Web.DynamicData
Assembly:  System.Web.DynamicData (em System.Web.DynamicData.dll)

System.Object
  System.Web.UI.Control
    System.Web.DynamicData.DynamicFilter

public class DynamicFilter : Control, IFilterExpressionProvider

NomeDescrição
System_CAPS_pubmethodDynamicFilter()

Inicializa uma nova instância da classe DynamicFilter.

NomeDescrição
System_CAPS_protpropertyAdapter

Obtém as especificações do navegador para o controle. (Herdado de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyBindingContainer

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o controle que contém a vinculação de dados desse controle.(Herdado de Control.)

System_CAPS_protpropertyChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.(Herdado de Control.)

System_CAPS_pubpropertyClientID

Obtém o identificador do controle gerado pelo ASP.NET. (Herdado de Control.)

System_CAPS_pubpropertyClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.(Herdado de Control.)

System_CAPS_protpropertyClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.(Herdado de Control.)

System_CAPS_protpropertyColumn

Obtém ou define a coluna da tabela a ser usado para filtragem.

System_CAPS_protpropertyContext

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.(Herdado de Control.)

System_CAPS_pubpropertyControls

Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.(Herdado de Control.)

System_CAPS_pubpropertyDataField

Obtém ou define o nome da coluna a ser usada para filtragem de linha de tabela.

System_CAPS_pubpropertyDataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.(Herdado de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.(Herdado de Control.)

System_CAPS_protpropertyDesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.(Herdado de Control.)

System_CAPS_pubpropertyEnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.(Herdado de Control.)

System_CAPS_pubpropertyEnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.(Herdado de Control.)

System_CAPS_protpropertyEvents

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.(Herdado de Control.)

System_CAPS_pubpropertyFilterTemplate

Obtém o modelo de filtro que é associado à instância atual deste controle.

System_CAPS_pubpropertyFilterUIHint

Obtém ou define o nome do modelo de filtro usado para criar a interface do usuário.

System_CAPS_protpropertyHasChildViewState

Obtém um valor indicando se os atuais controles filhos do controle do servidor têm quaisquer configurações do estado de visualização salvas.(Herdado de Control.)

System_CAPS_pubpropertyID

Obtém ou define o identificador programático atribuído ao controle de servidor.(Herdado de Control.)

System_CAPS_protpropertyIdSeparator

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o caractere usado para separar identificadores de controle.(Herdado de Control.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado do controle.(Herdado de Control.)

System_CAPS_protpropertyIsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando as alterações em seu estado de exibição.(Herdado de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.(Herdado de Control.)

System_CAPS_protpropertyLoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.(Herdado de Control.)

System_CAPS_pubpropertyNamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade Control.ID.(Herdado de Control.)

System_CAPS_pubpropertyPage

Obtém uma referência para a instância Page que contém o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyParent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.(Herdado de Control.)

System_CAPS_pubpropertyRenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.(Herdado de Control.)

System_CAPS_pubpropertySite

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.(Herdado de Control.)

System_CAPS_pubpropertySkinID

Obtém ou define a capa a ser aplicada ao controle.(Herdado de Control.)

System_CAPS_pubpropertyTemplateControl

Obtém ou define uma referência ao modelo que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.(Herdado de Control.)

System_CAPS_pubpropertyUniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.(Herdado de Control.)

System_CAPS_protpropertyViewState

Obtém um dicionário de informações de estado que permite você salvar e restaurar o estado de exibição de um controle de servidor nas várias solicitações para a mesma página. (Herdado de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.(Herdado de Control.)

System_CAPS_pubpropertyViewStateMode

Obtém ou define o modo de estado de exibição deste controle.(Herdado de Control.)

System_CAPS_pubpropertyVisible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.(Herdado de Control.)

NomeDescrição
System_CAPS_protmethodAddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.(Herdado de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.(Herdado de Control.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.(Herdado de Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Começa o rastreamento de tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Reúne informações sobre o controle de servidor e enviá-lo para o Trace propriedade a ser exibida quando o rastreamento está habilitado para a página.(Herdado de Control.)

System_CAPS_protmethodClearCachedClientID()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Define o valor ClientID armazenado em cache como null.(Herdado de Control.)

System_CAPS_protmethodClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildState()

Exclui as informações de estado de exibição e estado de controle para controles filho de todo o controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Conjuntos de ClientIDMode propriedade da instância atual do controle e de todos os controles filho para Inherit.(Herdado de Control.)

System_CAPS_protmethodCreateChildControls()

Chamado pela estrutura da página ASP.NET para notificar os controles de servidor que usam implementação baseada em composição para criar os controles filho que eles contêm em preparação para postagem ou processamento. (Herdado de Control.)

System_CAPS_protmethodCreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.(Herdado de Control.)

System_CAPS_pubmethodDataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.(Herdado de Control.)

System_CAPS_protmethodDataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.(Herdado de Control.)

System_CAPS_protmethodDataBindChildren()

Associa uma fonte de dados para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_pubmethodDispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.(Herdado de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Termina o rastreamento em tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodEnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.(Herdado de Control.)

System_CAPS_protmethodEnsureID()

Cria um identificador para controles que não têm um identificador atribuído.(Herdado de Control.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodFindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.(Herdado de Control.)

System_CAPS_protmethodFindControl(String, Int32)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.(Herdado de Control.)

System_CAPS_pubmethodFocus()

Define o foco de entrada para um controle.(Herdado de Control.)

System_CAPS_protmethodGetDesignModeState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.(Herdado de Control.)

System_CAPS_pubmethodHasControls()

Determina se o controle de servidor contém algum controle filho.(Herdado de Control.)

System_CAPS_protmethodHasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.(Herdado de Control.)

System_CAPS_protmethodIsLiteralContent()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Determina se o controle de servidor contém apenas o conteúdo literal.(Herdado de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState.(Herdado de Control.)

System_CAPS_protmethodLoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState.(Herdado de Control.)

System_CAPS_protmethodMapPathSecure(String)

Recupera o caminho físico que é mapeado para um caminho virtual, relativo ou absoluto.(Herdado de Control.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.(Herdado de Control.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Aciona o evento DataBinding.(Herdado de Control.)

System_CAPS_protmethodOnInit(EventArgs)

Aciona o evento Init.(Herdado de Control.)

System_CAPS_protmethodOnLoad(EventArgs)

Aciona o evento Load.(Herdado de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Aciona o evento PreRender.(Herdado de Control.)

System_CAPS_protmethodOnUnload(EventArgs)

Aciona o evento Unload.(Herdado de Control.)

System_CAPS_protmethodOpenFile(String)

Obtém um Stream usado para ler um arquivo.(Herdado de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.(Herdado de Control.)

System_CAPS_protmethodRemovedControl(Control)

Chamado após a remoção de um controle filho a Controls coleção do Control objeto.(Herdado de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Envia o conteúdo do controle de servidor especificado HtmlTextWriter objeto.(Substitui o Control.Render(HtmlTextWriter).)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.(Herdado de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.(Herdado de Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.(Herdado de Control.)

System_CAPS_protmethodResolveAdapter()

Obtém o adaptador de controle responsável por processar o controle especificado.(Herdado de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.(Herdado de Control.)

System_CAPS_pubmethodResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.(Herdado de Control.)

System_CAPS_protmethodSaveControlState()

Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.(Herdado de Control.)

System_CAPS_protmethodSaveViewState()

Salva quaisquer alterações no viewstate de um controle de servidor que ocorreram apos o último postback da página.(Herdado de Control.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_protmethodTrackViewState()

Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. Esse objeto é acessível por meio da propriedade Control.ViewState.(Herdado de Control.)

NomeDescrição
System_CAPS_pubeventDataBinding

Ocorre quando o server control vincula a uma fonte de dados.(Herdado de Control.)

System_CAPS_pubeventDisposed

Ocorre quando um server control é liberado da memória, que é a última etapa do ciclo de vida do server contorl quando uma página ASP.NET é solicitada.(Herdado de Control.)

System_CAPS_pubeventFilterChanged

Ocorre quando o usuário seleciona um valor para a chave estrangeira.

System_CAPS_pubeventInit

Ocorre quando o server control é inicializado, que é o primeiro passo em seu ciclo de vida.(Herdado de Control.)

System_CAPS_pubeventLoad

Ocorre quando o controle de servidor é carregado no objeto Page.(Herdado de Control.)

System_CAPS_pubeventPreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.(Herdado de Control.)

System_CAPS_pubeventUnload

Ocorre quando o server control é descarregado da memória.(Herdado de Control.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIFilterExpressionProvider.GetQueryable(IQueryable)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém a consulta modificada usando o valor do filtro atual.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIFilterExpressionProvider.Initialize(IQueryableDataSource)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Inicializa uma nova instância da classe DynamicFilter.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.GetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetOwnerControl.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, consulte IParserAccessor.AddParsedSubObject.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, consulte IControlBuilderAccessor.ControlBuilder.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.UserData.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.DataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.HasDataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.Expressions.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.HasExpressions.(Herdado de Control.)

NomeDescrição
System_CAPS_pubmethodFindDataSourceControl()

Retorna a fonte de dados associada ao controle de dados do controle especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retorna que o modelo de campo para a coluna especificada no controle especificado do contêiner de nomeação.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retorna o objeto metatable contendo o controle de dados.(Definido pelo DynamicDataExtensions.)

The T:System.Web.DynamicData.DynamicFilter control is used in a page markup to generate the UI for filtering table rows. Dynamic Data creates the UI by using the default filter templates that are in the ~\DynamicData\Filters folder. These templates support foreign-key, Boolean, and enumeration column types.

The following table shows some of the tasks you can perform.

Scenario

Description

Specify the column to use for table row filtering.

Use the property P:System.Web.DynamicData.DynamicFilter.DataField to specify the column to use for table row filtering.

Specify the name of the filter template to use to create the UI.

Use the property P:System.Web.DynamicData.DynamicFilter.FilterUIHint to specify the name of the filter template to use to create the UI.

Perform custom operations before the UI is rendered.

Use the E:System.Web.DynamicData.DynamicFilter.FilterChanged to perform custom operations before the UI is rendered.

You can specify the filter template to use in the following ways:

  • By using the P:System.Web.DynamicData.DynamicFilter.FilterUIHint property in page markup. This approach is a presentation-layer customization, which is independent of the schema (database), and which applies to a single page.

  • By using the T:System.ComponentModel.DataAnnotations.FilterUIHintAttribute attribute in the model. This approach is a data-layer customization, which depends on the specific schema (database), and which applies to the entire application.

If you use both approaches, the filter template that is specified in the markup takes precedence over the template that is specified in the data model.

The T:System.Web.DynamicData.DynamicFilter control is designed to work with the T:System.Web.UI.WebControls.QueryExtender control. The T:System.Web.DynamicData.DynamicFilter control is referenced by a T:System.Web.DynamicData.DynamicFilterExpression instance inside a T:System.Web.UI.WebControls.QueryExtender object in the page markup.

The following figure shows the steps that Dynamic Data follows in order to implement table row filtering by a foreign-key column.

Elementos de consulta de dados dinâmicos
  1. The T:System.Web.DynamicData.DynamicFilter control passes the selected value to the T:System.Web.UI.WebControls.QueryExtender control.

  2. The T:System.Web.UI.WebControls.QueryExtender control uses the value to create the query filtering information. It then passes this information to the data source control.

  3. The data source control passes the filtering query information to the data source provider.

  4. The data source provider passes the query to the database.

  5. The database returns the filtered table rows.

  6. The data source provider sends this data back to the data source control.

  7. The data source control passes the filtered table rows to the data-bound control for display.

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

A Visual Studio project with source code is available at this location: Downloadhttp://go.microsoft.com/fwlink/?LinkId=168914.

The following examples use the default ForeignKey.ascx filter template to create the UI for filtering the Products table rows by the ProductCategory foreign-key column. When the user selects a ProductCategory value, only the rows that contain that value are displayed.

The example requires the following:

  • A Dynamic Data Web site or a Dynamic Data Web application. This enables you to create the AdventureWorksLTDataContext data context for the database and to create the classes for the tables to access. For more information, see 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" /> &nbsp; &nbsp;
            <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>
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;

        }

    }

.NET Framework
Disponível desde 4.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: