ControlFilterExpression Classe

Definição

Espaço de Nomes:
System.Web.DynamicData
Assemblagem:
System.Web.DynamicData.dll

Modifica uma consulta de base de dados utilizando a chave de dados do item selecionado num controlo de dados vinculado.

public ref class ControlFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression
public class ControlFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression
type ControlFilterExpression = class
    inherit DataSourceExpression
Public Class ControlFilterExpression
Inherits DataSourceExpression
Herança
Object
DataSourceExpression
ControlFilterExpression

Exemplos

O exemplo seguinte mostra como usar a ControlFilterExpression classe para referenciar um controlo databound de origem, onde a chave de dados é selecionada. O controlo QueryExtender aponta para um controlo de fonte de dados alvo que obtém dados filtrados usando a chave de dados selecionada. No exemplo, o controlo databound de origem refere-se a uma tabela pai e o controlo databound de destino refere-se a uma tabela filha.

<asp:QueryExtender ID="QueryExtenderID"
    TargetControlID="TargetDataSourceID" runat="server">
    <asp:ControlFilterExpression ControlID="SourceGridViewID" />
</asp:QueryExtender>

Observações

A ControlFilterExpression classe concebida para ser usada quando uma página contém dois controlos encadernados por dados, como um GridView controlo e um ListView controlo. Um dos controlos é a fonte, onde uma chave de dados (linha) é selecionada. O outro controlo é o alvo onde os dados são exibidos com base na chave de dados selecionada. Os dados alvo são obtidos por um controlo de fonte de dados que executa a consulta definida na QueryExtender classe e que é construída usando a chave de dados selecionada.

Para usar a ControlFilterExpression classe numa página, segue estes passos:

Construtores

Name Description
ControlFilterExpression()

Inicializa uma nova instância da ControlFilterExpression classe.

Propriedades

Name Description
Column

Obtém ou define o nome da coluna em que a consulta se baseia.
Context

Obtém a HttpContext instância do controlo do proprietário.

(Herdado de DataSourceExpression)
ControlID

Obtém ou define o ID do controlo ligado a dados de origem.
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)

Faz com que a consulta da fonte de dados seja modificada.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadViewState(Object)

Restaura o estado de visualização previamente guardado.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
SaveViewState()

Guarda as alterações para o estado de visualização desde o momento em que a página foi publicada no servidor.
SetContext(Control, HttpContext, IQueryableDataSource)

Inicializa a expressão do filtro 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()

Faz com que o ControlFilterExpression objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto de estado de vista do controlo e sejam persistidas entre pedidos para a mesma página.

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)

Aplica-se a

Ver também