SearchExpression Classe

Définition

Espace de noms:

System.Web.UI.WebControls.Expressions

Assembly:

System.Web.Extensions.dll

Fournit un moyen de rechercher un champ ou des champs pour les valeurs de chaîne et de les comparer à une valeur de chaîne spécifiée.

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

Héritage

Object

DataSourceExpression

ParameterDataSourceExpression

SearchExpression

Exemples

L’exemple suivant montre comment rechercher la colonne Name dans la table Products de la base de données AdventureWorks pour les produits dont la chaîne est spécifiée dans le SearchTextBox contrôle. Le résultat retourné par le LinqDataSource contrôle s’affiche dans un GridView contrôle.

Cet exemple de code fait partie d’un exemple plus large fourni dans la procédure pas à pas : filtrage des données dans une page web à l’aide de la syntaxe déclarative.

Remarques

Le QueryExtender contrôle permet de filtrer les données d’une page Web à l’aide de la SearchExpression classe. La SearchExpression classe compare une chaîne spécifiée dans un champ ou des champs à une valeur que vous fournissez. L’expression effectue une recherche « commence par », « contains » ou « se termine par ». Vous devez spécifier des valeurs pour les SearchType propriétés et DataFields les propriétés afin d’indiquer le type de recherche que vous souhaitez effectuer et les champs de données que vous souhaitez rechercher. Si le fournisseur LINQ que vous utilisez dans le QueryExtender contrôle prend en charge la sensibilité de la casse, vous pouvez utiliser la propriété pour activer ou ignorer la ComparisonType sensibilité de la casse.

La valeur à rechercher peut être fournie par un contrôle ASP.NET. Pour spécifier cela, vous définissez la ControlID propriété de la ControlParameter classe dans l’objet SearchExpression sur l’ID d’un contrôle ASP.NET. Par exemple, si la valeur à rechercher est entrée dans une zone de texte, la ControlID propriété doit être définie sur l’ID du contrôle de zone de texte. Vous pouvez utiliser la SearchExpression classe en combinaison avec les autres expressions que les QueryExtender supports, telles que le RangeExpression filtre. Par exemple, vous pouvez rechercher des noms de produits qui contiennent la chaîne « thé » et un prix de liste compris entre 100 et 200.

Constructeurs

Nom	Description
SearchExpression()	Initialise une nouvelle instance de la classe SearchExpression.

Propriétés

Nom	Description
ComparisonType	Obtient ou définit le type de comparaison de chaînes à effectuer.
Context	Obtient l’instance HttpContext du contrôle propriétaire. (Hérité de DataSourceExpression)
DataFields	Obtient ou définit un champ unique ou une liste séparée par des virgules de champs à rechercher.
DataSource	Obtient l’objet de source de données associé au contrôle propriétaire. (Hérité de DataSourceExpression)
IsTrackingViewState	Obtient une valeur qui indique si un objet d’expression de source de données suit ses modifications d’état d’affichage. (Hérité de DataSourceExpression)
Owner	Obtient le contrôle propriétaire. (Hérité de DataSourceExpression)
Parameters	Obtient les paramètres associés à cet DataSourceExpression objet. (Hérité de ParameterDataSourceExpression)
SearchType	Obtient ou définit la SearchType valeur qui détermine où se produit la recherche dans la chaîne.
ViewState	Obtient une instance de la StateBag classe qui contient les informations d’état d’affichage actuelles. (Hérité de DataSourceExpression)

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetQueryable(IQueryable)	Applique un SearchExpression objet à l’objet spécifié IQueryable en fonction de l’objet SearchType .
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadViewState(Object)	Charge l’état des valeurs dans l’objet ParameterDataSourceExpression qui doit être conservé. (Hérité de ParameterDataSourceExpression)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
SaveViewState()	Enregistre l’état d’affichage actuel de l’objet ParameterDataSourceExpression . (Hérité de ParameterDataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource)	Exécute l’expression à l’aide du contrôle, du contexte et de la source de données spécifiés. (Hérité de ParameterDataSourceExpression)
SetDirty()	Marque l’objet DataSourceExpression afin que son état soit enregistré dans l’état d’affichage. (Hérité de DataSourceExpression)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Effectue le suivi des modifications de l’état d’affichage de l’objet ParameterDataSourceExpression afin que les modifications puissent être stockées dans l’objet StateBag pour l’objet. (Hérité de ParameterDataSourceExpression)

Implémentations d’interfaces explicites

Nom	Description
IStateManager.IsTrackingViewState	En cas d’implémentation par une classe, obtient une valeur qui indique si un objet d’expression de source de données suit ses modifications d’état d’affichage. (Hérité de DataSourceExpression)
IStateManager.LoadViewState(Object)	En cas d’implémentation par une classe, charge l’état d’affichage précédemment enregistré de l’objet d’expression de source de données. (Hérité de DataSourceExpression)
IStateManager.SaveViewState()	En cas d’implémentation par une classe, enregistre l’état d’affichage actuel de l’objet DataSourceExpression . (Hérité de DataSourceExpression)
IStateManager.TrackViewState()	En cas d’implémentation par une classe, suit les modifications de l’état d’affichage de l’objet DataSourceExpression afin que les modifications puissent être stockées dans l’objet StateBag pour l’objet d’expression de source de données. (Hérité de DataSourceExpression)

Voir aussi

• QueryExtender
• Vue d’ensemble du contrôle de serveur Web QueryExtender