ControlFilterExpression Classe

Referência

Definição

Namespace:: System.Web.DynamicData

Assembly:: System.Web.DynamicData.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Modifica uma consulta de banco de dados usando a chave de dados do item selecionado em um controle associado a dados.

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 a seguir mostra como usar a ControlFilterExpression classe para fazer referência a um controle associado a dados de origem, onde a chave de dados é selecionada. O QueryExtender controle aponta para um controle da fonte de dados de destino que obtém dados que são filtrados usando a chave de dados selecionada. No exemplo, o controle associado a dados de origem faz referência a uma tabela pai e o controle associado a dados de destino faz referência a uma tabela filho.

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

Comentários

A ControlFilterExpression classe que foi projetada para ser usada quando uma página contém dois controles vinculados a dados, como um GridView controle e um ListView controle. Um controle é a origem, em que uma chave de dados (linha) é selecionada. O outro controle é o destino em que os dados são exibidos com base na chave de dados selecionada. Os dados de destino são obtidos por um controle da fonte de dados que executa a consulta que é definida na QueryExtender classe e que é criada usando a chave de dados selecionada.

Para usar a ControlFilterExpression classe em uma página, siga estas etapas:

Adicione o QueryExtender controle à página.
Defina a TargetControlID Propriedade do QueryExtender controle como a ID do controle da fonte de dados de destino.
Adicione uma ControlFilterExpression instância ao QueryExtender controle.
Defina a ControlID Propriedade do ControlFilterExpression elemento como o controle associado a dados de origem.

Construtores

ControlFilterExpression()

Inicializa uma nova instância da classe ControlFilterExpression.

Propriedades

Column	Obtém ou define o nome da coluna em que a consulta se baseia.
Context	Obtém a instância HttpContext do controle de proprietário. (Herdado de DataSourceExpression)
ControlID	Obtém ou define a ID do controle associado a dados de origem.
DataSource	Obtém o objeto de fonte de dados associado ao controle de proprietário. (Herdado de DataSourceExpression)
IsTrackingViewState	Obtém um valor que indica se um objeto de expressão da fonte de dados está controlando suas alterações de estado de exibição. (Herdado de DataSourceExpression)
Owner	Obtém o controle de proprietário. (Herdado de DataSourceExpression)
ViewState	Obtém uma instância da classe StateBag que contém informações atuais de estado de exibição. (Herdado de DataSourceExpression)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetQueryable(IQueryable)	Obtém a consulta da fonte de dados a ser modificada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SaveViewState()	Salva as alterações para o estado de exibição desde a hora em que a página foi postada no servidor.
SetContext(Control, HttpContext, IQueryableDataSource)	Inicializa a expressão de filtro com informações sobre a fonte de dados.
SetDirty()	Marca o objeto DataSourceExpression para que seu estado seja salvo no estado de exibição. (Herdado de DataSourceExpression)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o objeto ControlFilterExpression controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas no objeto de estado de exibição do controle e persistidas entre solicitações para a mesma página.

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Quando implementado por uma classe, obtém um valor que indica se um objeto de expressão da fonte de dados está controlando suas alterações de estado de exibição. (Herdado de DataSourceExpression)
IStateManager.LoadViewState(Object)	Quando implementado por uma classe, carrega o estado de exibição salvo anteriormente do objeto de expressão da fonte de dados. (Herdado de DataSourceExpression)
IStateManager.SaveViewState()	Quando implementado por uma classe, salva o estado de exibição atual do objeto DataSourceExpression. (Herdado de DataSourceExpression)
IStateManager.TrackViewState()	Quando implementado por uma classe, controla as alterações de estado de exibição do objeto DataSourceExpression, de modo que as alterações possam ser armazenadas no objeto StateBag para o objeto de expressão da fonte de dados. (Herdado de DataSourceExpression)

Aplica-se a