SearchExpression Classe
Definição
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.Provides a way to search a field or fields for string values and compare them to a specified string value.
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
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.The following example shows how to search the Name column in the Products table of the AdventureWorks database for products whose that start with the string that is specified in the SearchTextBox control. O resultado retornado do LinqDataSource controle é exibido em um GridView controle.The result that is returned from the LinqDataSource control is displayed in a GridView control.
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.This code example is part of a larger example that is provided in Walkthrough: Filtering Data in a Web Page Using Declarative Syntax.
Comentários
O QueryExtender controle fornece a capacidade de filtrar dados em uma página da Web usando a SearchExpression classe.The QueryExtender control provides the ability to filter data in a Web page by using the SearchExpression class. A SearchExpression classe compara uma cadeia de caracteres especificada em um campo ou campos com um valor que você fornece.The SearchExpression class compares a specified string in a field or fields to a value that you supply. A expressão executa uma pesquisa "começa com", "contém" ou "termina com".The expression performs a "starts with", "contains", or "ends with" search. 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.You must specify values for the SearchType and the DataFields properties in order to indicate the type of search you want to perform and the data fields that you want to search. 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úsculasIf the LINQ provider that you use in the QueryExtender control supports case sensitivity, you can use the ComparisonType property to enable or ignore case sensitivity.
O valor a ser pesquisado pode ser fornecido por um controle ASP.NET.The value to search can be provided by an ASP.NET control. Para especificar isso, defina a ControlID propriedade da ControlParameter classe no SearchExpression objeto como a ID de um controle ASP.net.To specify this, you set the ControlID property of the ControlParameter class in the SearchExpression object to the ID of a ASP.NET control. 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.For example, if the value to search is entered in a text box, the ControlID property must be set to the ID of the text box control. Você pode usar a SearchExpression classe em combinação com as outras expressões que o QueryExtender suporta, como o RangeExpression filtro.You can use the SearchExpression class in combination with the other expressions that the QueryExtender supports, such as the RangeExpression filter. 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.For example, you can search for product names that contain the string "tea" and a list price between 100 and 200.
Construtores
| SearchExpression() |
Inicializa uma nova instância da classe SearchExpression.Initializes a new instance of the SearchExpression class. |
Propriedades
| ComparisonType |
Obtém ou define o tipo de comparação de cadeia de caracteres a ser executada.Gets or sets the type of string comparison to perform. |
| Context |
Obtém a instância HttpContext do controle de proprietário.Gets the HttpContext instance of the owner control. (Herdado de DataSourceExpression) |
| DataFields |
Obtém ou define um único campo ou uma lista separada por vírgula de campos a serem pesquisados.Gets or sets a single field or a comma-separated list of fields to search. |
| DataSource |
Obtém o objeto de fonte de dados associado ao controle de proprietário.Gets the data source object that is associated with the owner control. (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.Gets a value that indicates whether a data source expression object is tracking its view state changes. (Herdado de DataSourceExpression) |
| Owner |
Obtém o controle de proprietário.Gets the owner control. (Herdado de DataSourceExpression) |
| Parameters |
Obtém os parâmetros associados a este objeto DataSourceExpression.Gets the parameters that are associated with this DataSourceExpression object. (Herdado de ParameterDataSourceExpression) |
| SearchType |
Obtém ou define o valor SearchType que determina o ponto na cadeia de caracteres em que a pesquisa ocorre.Gets or sets the SearchType value that determines where in the string the search occurs. |
| ViewState |
Obtém uma instância da classe StateBag que contém informações atuais de estado de exibição.Gets an instance of the StateBag class that contains the current view state information. (Herdado de DataSourceExpression) |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetQueryable(IQueryable) |
Aplica um objeto SearchExpression ao objeto IQueryable especificado com base no objeto SearchType.Applies a SearchExpression object to the specified IQueryable object based on the SearchType object. |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| LoadViewState(Object) |
Carrega o estado dos valores no objeto ParameterDataSourceExpression que deve ser persistente.Loads the state of the values in the ParameterDataSourceExpression object that must be persisted. (Herdado de ParameterDataSourceExpression) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| SaveViewState() |
Salva o estado de exibição atual do objeto ParameterDataSourceExpression.Saves the current view state of the ParameterDataSourceExpression object. (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.Executes the expression by using the specified owner control, context, and data source. (Herdado de ParameterDataSourceExpression) |
| SetDirty() |
Marca o objeto DataSourceExpression para que seu estado seja salvo no estado de exibição.Marks the DataSourceExpression object so that its state will be saved in view state. (Herdado de DataSourceExpression) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (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.Tracks view-state changes of the ParameterDataSourceExpression object so that the changes can be stored in the StateBag object for the object. (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.When implemented by a class, gets a value that indicates whether a data source expression object is tracking its view state changes. (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.When implemented by a class, loads the previously saved view state of the data source expression object. (Herdado de DataSourceExpression) |
| IStateManager.SaveViewState() |
Quando implementado por uma classe, salva o estado de exibição atual do objeto DataSourceExpression.When implemented by a class, saves the current view state of the DataSourceExpression object. (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.When implemented by a class, tracks view state changes of the DataSourceExpression object so that the changes can be stored in the StateBag object for the data source expression object. (Herdado de DataSourceExpression) |