SearchExpression Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma forma de pesquisar num campo ou campos valores de cadeia e compará-los com um valor especificado de cadeia.
public ref class SearchExpression : System::Web::UI::WebControls::Expressions::ParameterDataSourceExpressionpublic class SearchExpression : System.Web.UI.WebControls.Expressions.ParameterDataSourceExpressiontype SearchExpression = class
inherit ParameterDataSourceExpressionPublic Class SearchExpression
Inherits ParameterDataSourceExpression- Herança
Exemplos
O exemplo seguinte mostra como pesquisar a coluna Nome na tabela Produtos da base de dados AdventureWorks para produtos que começam com a cadeia especificada no SearchTextBox controlo. O resultado que é devolvido pelo LinqDataSource controlo é apresentado num GridView controlo.
Este exemplo de código faz parte de um exemplo maior fornecido em Walkthrough: Filtering Data in a Web Page Using Declarative Syntax.
Observações
O QueryExtender controlo permite filtrar dados numa página Web utilizando a SearchExpression classe. A SearchExpression classe compara uma cadeia específica num campo ou campos com um valor que forneces. A expressão realiza uma pesquisa "começa com", "contém" ou "termina com". Deve especificar valores para as SearchType propriedades e DataFields para indicar o tipo de pesquisa que pretende realizar e os campos de dados que pretende pesquisar. Se o fornecedor LINQ que usa no QueryExtender controlo suportar sensibilidade a maiúsculas minúsculas, pode usar a ComparisonType propriedade para ativar ou ignorar a sensibilidade a maiúsculas minúsculas.
O valor a pesquisar pode ser fornecido por um controlo ASP.NET. Para especificar isto, define a propriedade ControlID da classe ControlParameter no objeto SearchExpression para o ID de um controlo ASP.NET. Por exemplo, se o valor a pesquisar for introduzido numa caixa de texto, a ControlID propriedade deve ser definida para o ID do controlo da caixa de texto. Pode usar a SearchExpression classe em combinação com as outras expressões que suporta QueryExtender , como o RangeExpression filtro. Por exemplo, pode procurar nomes de produtos que contenham a cadeia "tea" e um preço de tabela entre 100 e 200.
Construtores
| Name | Description |
|---|---|
| SearchExpression() |
Inicializa uma nova instância da SearchExpression classe. |
Propriedades
| Name | Description |
|---|---|
| ComparisonType |
Obtém ou define o tipo de comparação de cordas a executar. |
| Context |
Obtém a HttpContext instância do controlo do proprietário. (Herdado de DataSourceExpression) |
| DataFields |
Obtém ou define um único campo ou uma lista separada por vírgulas de campos para pesquisar. |
| 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) |
| Parameters |
Obtém os parâmetros associados a este DataSourceExpression objeto. (Herdado de ParameterDataSourceExpression) |
| SearchType |
Obtém ou define o SearchType valor que determina em que parte da cadeia ocorre a pesquisa. |
| 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) |
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 mantidos. (Herdado de ParameterDataSourceExpression) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| SaveViewState() |
Guarda o estado atual da vista do ParameterDataSourceExpression objeto. (Herdado de ParameterDataSourceExpression) |
| SetContext(Control, HttpContext, IQueryableDataSource) |
Executa a expressão usando o controlo do proprietário, contexto e fonte de dados especificados. (Herdado de ParameterDataSourceExpression) |
| 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() |
Acompanha as alterações de estado de visualização do ParameterDataSourceExpression objeto para que as alterações possam ser armazenadas no StateBag objeto para o objeto. (Herdado de ParameterDataSourceExpression) |
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) |