SearchExpression Classe

Definição

Namespace:

System.Web.UI.WebControls.Expressions

Assembly:

System.Web.Extensions.dll

Fornece uma maneira de pesquisar valores de cadeia de caracteres em um campo ou campos e compará-los com um valor de cadeia de caracteres especificado.

public ref class SearchExpression : System::Web::UI::WebControls::Expressions::ParameterDataSourceExpression

public class SearchExpression : System.Web.UI.WebControls.Expressions.ParameterDataSourceExpression

type SearchExpression = class
    inherit ParameterDataSourceExpression

Public Class SearchExpression
Inherits ParameterDataSourceExpression

Herança

Object

DataSourceExpression

ParameterDataSourceExpression

SearchExpression

Exemplos

O exemplo a seguir mostra como pesquisar a coluna Name na tabela Produtos do banco de dados AdventureWorks em busca de produtos cujos resultados começam com a cadeia de caracteres especificada no SearchTextBox controle. O resultado retornado do LinqDataSource controle é exibido em um GridView controle.

Este exemplo de código faz parte de um exemplo maior fornecido em Passo a passo: filtrando dados em uma página da Web usando sintaxe declarativa.

Comentários

O QueryExtender controle fornece a capacidade de filtrar dados em uma página da Web usando a SearchExpression classe. A SearchExpression classe compara uma cadeia de caracteres especificada em um campo ou campos com um valor que você fornece. A expressão executa uma pesquisa "começa com", "contém" ou "termina com". Você deve especificar valores para as propriedades e as SearchTypeDataFields propriedades para indicar o tipo de pesquisa que deseja executar e os campos de dados que deseja pesquisar. Se o provedor LINQ usado no controle der suporte à QueryExtender confidencialidade de maiúsculas e minúsculas, você poderá usar a ComparisonType propriedade para habilitar ou ignorar a confidencialidade de maiúsculas e minúsculas.

O valor a ser pesquisado pode ser fornecido por um controle ASP.NET. Para especificar isso, defina a ControlID propriedade da ControlParameter classe no SearchExpression objeto como a ID de um controle ASP.NET. Por exemplo, se o valor a ser pesquisado for inserido em uma caixa de texto, a ControlID propriedade deverá ser definida como a ID do controle da caixa de texto. Você pode usar a SearchExpression classe em combinação com as outras expressões compatíveis QueryExtender , como o RangeExpression filtro. Por exemplo, você pode pesquisar nomes de produtos que contêm a cadeia de caracteres "chá" e um preço de lista entre 100 e 200.

Construtores

Nome	Description
SearchExpression()	Inicializa uma nova instância da classe SearchExpression.

Propriedades

Nome	Description
ComparisonType	Obtém ou define o tipo de comparação de cadeia de caracteres a ser executada.
Context	Obtém a HttpContext instância do controle de proprietário. (Herdado de DataSourceExpression)
DataFields	Obtém ou define um único campo ou uma lista separada por vírgulas de campos a serem pesquisados.
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)
Parameters	Obtém os parâmetros associados a esse DataSourceExpression objeto. (Herdado de ParameterDataSourceExpression)
SearchType	Obtém ou define o SearchType valor que determina onde na cadeia de caracteres a pesquisa ocorre.
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 de hash padrão. (Herdado de Object)
GetQueryable(IQueryable)	Aplica um SearchExpression objeto ao objeto especificado IQueryable com base no SearchType objeto.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Carrega o estado dos valores no ParameterDataSourceExpression objeto que devem ser persistidos. (Herdado de ParameterDataSourceExpression)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
SaveViewState()	Salva o estado de exibição atual do ParameterDataSourceExpression objeto. (Herdado de ParameterDataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource)	Executa a expressão usando o controle de proprietário, o contexto e a fonte de dados especificados. (Herdado de ParameterDataSourceExpression)
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()	Controla as alterações de estado de exibição do ParameterDataSourceExpression objeto para que as alterações possam ser armazenadas no StateBag objeto do objeto. (Herdado de ParameterDataSourceExpression)

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)

Confira também

• QueryExtender
• Visão geral do controle do servidor Web QueryExtender