DynamicFilterExpression Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Modifica uma consulta de base de dados usando um valor do controlo de filtro especificado.
public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpressionpublic class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpressiontype DynamicFilterExpression = class
inherit DataSourceExpressionPublic Class DynamicFilterExpression
Inherits DataSourceExpression- Herança
Exemplos
O exemplo seguinte mostra como usar o DynamicFilterExpression controlo para selecionar um modelo de filtro numa página. O modelo do filtro é selecionado pelo DynamicFilter controlo identificado pelo DynamicFilterExpression controlo através da sua ControlID propriedade.
<asp:QueryExtender ID="QueryExtender1"
TargetControlID="GridDataSource" runat="server">
<asp:DynamicFilterExpression ControlID="CategoryFilterID" />
</asp:QueryExtender>
Observações
A DynamicFilterExpression classe permite-lhe modificar uma consulta à base de dados usando os valores atribuídos num DynamicFilter controlo. Este controlo delega a tarefa de construir a IQueryable consulta a um controlo especializado, como QueryableFilterRepeater controlo ou DynamicFilter controlo.
Os controlos de filtro, por sua vez, delegam a construção da consulta ao template de filtro que referenciam. A consulta é então executada pelo controlo de fonte de dados referenciado pelo QueryExtender controlo.
Para usar a DynamicFilterExpression classe numa página, segue estes passos:
Adicione um QueryExtender controlo à página.
Defina a
TargetControlIDpropriedade do QueryExtender controlo para referenciar o controlo fonte de dados.Adiciona um DynamicFilterExpression objeto como filho do QueryExtender controlo.
Defina a
ControlIDpropriedade do DynamicFilterExpression objeto para referenciar o controlo do filtro.
Nos passos anteriores, assume-se que os controlos de filtro relacionados, controlos de dados vinculados e controlo de fonte de dados estão definidos na página.
Construtores
| Name | Description |
|---|---|
| DynamicFilterExpression() |
Inicializa uma nova instância da DynamicFilterExpression classe. |
Propriedades
| Name | Description |
|---|---|
| Context |
Obtém a HttpContext instância do controlo do proprietário. (Herdado de DataSourceExpression) |
| ControlID |
Obtém ou define o identificador de controlo do filtro. |
| DataSource |
Obtém o objeto fonte de dados associado ao controlo do proprietário. (Herdado de DataSourceExpression) |
| IsTrackingViewState |
Recebe um valor que indica se um objeto de expressão de fonte de dados está a acompanhar as alterações no estado da sua visualização. (Herdado de DataSourceExpression) |
| Owner |
Fica com o controlo do dono. (Herdado de DataSourceExpression) |
| ViewState |
Obtém uma instância da StateBag classe que contém a informação atual do estado da vista. (Herdado de DataSourceExpression) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetQueryable(IQueryable) |
Obtém a consulta modificada usando o valor atual do filtro. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| LoadViewState(Object) |
Carrega o estado dos valores no DataSourceExpression objeto que devem ser mantidos. (Herdado de DataSourceExpression) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| SaveViewState() |
Guarda o estado atual da vista do DataSourceExpression objeto. (Herdado de DataSourceExpression) |
| SetContext(Control, HttpContext, IQueryableDataSource) |
Inicializa a expressão com a informação da fonte de dados. |
| SetDirty() |
Marca o DataSourceExpression objeto para que o seu estado seja guardado no estado de visualização. (Herdado de DataSourceExpression) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Acompanha as alterações no estado da vista do DataSourceExpression objeto para que as alterações possam ser armazenadas no StateBag objeto para o objeto de expressão da fonte de dados. (Herdado de DataSourceExpression) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IStateManager.IsTrackingViewState |
Quando implementado por uma classe, obtém um valor que indica se um objeto de expressão de fonte de dados está a acompanhar as alterações do estado da sua visualização. (Herdado de DataSourceExpression) |
| IStateManager.LoadViewState(Object) |
Quando implementado por uma classe, carrega o estado de visualização previamente guardado do objeto de expressão da fonte de dados. (Herdado de DataSourceExpression) |
| IStateManager.SaveViewState() |
Quando implementado por uma classe, guarda o estado atual da vista do DataSourceExpression objeto. (Herdado de DataSourceExpression) |
| IStateManager.TrackViewState() |
Quando implementado por uma classe, acompanha as alterações no estado da vista do DataSourceExpression objeto para que as alterações possam ser armazenadas no StateBag objeto para o objeto de expressão da fonte de dados. (Herdado de DataSourceExpression) |