ControlFilterExpression Classe
Definição
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::DataSourceExpressionpublic class ControlFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpressiontype ControlFilterExpression = class
inherit DataSourceExpressionPublic Class ControlFilterExpression
Inherits DataSourceExpression- Herança
Exemplos
O exemplo a seguir mostra como usar a ControlFilterExpression classe para fazer referência a um controle associado a dados de origem, em que a chave de dados está selecionada. O QueryExtender controle aponta para um controle de fonte de dados de destino que obtém dados 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 projetada para ser usada quando uma página contém dois controles associados 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 de fonte de dados que executa a consulta 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
TargetControlIDpropriedade do QueryExtender controle como a ID do controle da fonte de dados de destino.Adicione uma ControlFilterExpression instância ao QueryExtender controle.
Defina a
ControlIDpropriedade do ControlFilterExpression elemento como o controle associado a dados de origem.
Construtores
| Nome | Description |
|---|---|
| ControlFilterExpression() |
Inicializa uma nova instância da classe ControlFilterExpression. |
Propriedades
| Nome | Description |
|---|---|
| Column |
Obtém ou define o nome da coluna na qual a consulta se baseia. |
| Context |
Obtém a HttpContext instância 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 de fonte de dados está acompanhando 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 StateBag classe que contém as informações de estado de exibição atuais. (Herdado de DataSourceExpression) |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função hash predefinida. (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 Objectatual. (Herdado de Object) |
| SaveViewState() |
Salva as alterações no 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 da fonte de dados. |
| SetDirty() |
Marca o DataSourceExpression objeto 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 ControlFilterExpression objeto acompanhe as alterações em seu estado de exibição para 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
| Nome | 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á acompanhando 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 DataSourceExpression objeto. (Herdado de DataSourceExpression) |
| IStateManager.TrackViewState() |
Quando implementado por uma classe, rastreia as alterações de estado de exibição 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) |