SearchExpression Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls.Expressions

Assembly:: System.Web.Extensions.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.

Fornece uma maneira de pesquisar valores de cadeia de caracteres em um ou mais 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 Products do banco de dados AdventureWorks para produtos cujo início 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 é parte de um exemplo maior que é fornecido em Walkthrough: 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 SearchType Propriedades e DataFields para indicar o tipo de pesquisa que deseja executar e os campos de dados que deseja pesquisar. Se o provedor LINQ que você usa no QueryExtender controle dá suporte à distinção de maiúsculas e minúsculas, você pode usar a ComparisonType propriedade para habilitar ou ignorar a diferenciação 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 que o QueryExtender suporta, como o RangeExpression filtro. Por exemplo, você pode procurar nomes de produtos que contenham a cadeia de caracteres "chá" e um preço de lista entre 100 e 200.

Construtores

SearchExpression()

Inicializa uma nova instância da classe SearchExpression.

Propriedades

ComparisonType	Obtém ou define o tipo de comparação de cadeia de caracteres a ser executada.
Context	Obtém a instância HttpContext do controle de proprietário. (Herdado de DataSourceExpression)
DataFields	Obtém ou define um único campo ou uma lista separada por vírgula 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 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)
Parameters	Obtém os parâmetros associados a este objeto DataSourceExpression. (Herdado de ParameterDataSourceExpression)
SearchType	Obtém ou define o valor SearchType que determina o ponto na cadeia de caracteres em que a pesquisa ocorre.
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)	Aplica um objeto SearchExpression ao objeto IQueryable especificado com base no objeto SearchType.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Carrega o estado dos valores no objeto ParameterDataSourceExpression que deve ser persistente. (Herdado de ParameterDataSourceExpression)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SaveViewState()	Salva o estado de exibição atual do objeto ParameterDataSourceExpression. (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 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()	Controla as alterações de estado de exibição no objeto ParameterDataSourceExpression de modo as alterações possam ser armazenadas no objeto StateBag para o objeto. (Herdado de ParameterDataSourceExpression)

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

Partilhar via