Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
SearchExpression, classe
Offre un moyen de rechercher des valeurs de chaîne dans un champ ou des champs et de les comparer à une valeur de chaîne spécifiée.
System.Web.UI.WebControls.Expressions.DataSourceExpression
System.Web.UI.WebControls.Expressions.ParameterDataSourceExpression
System.Web.UI.WebControls.Expressions.SearchExpression
Assembly : System.Web.Extensions (dans System.Web.Extensions.dll)
Le type SearchExpression expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
SearchExpression | Initialise une nouvelle instance de la classe SearchExpression. |
| Nom | Description | |
|---|---|---|
|
ComparisonType | Obtient ou définit le type de comparaison de chaînes à exécuter. |
|
Context | Obtient l'instance HttpContext du contrôle propriétaire. (Hérité de DataSourceExpression.) |
|
|
DataFields | Obtient et définit un champ unique ou une liste séparée par des virgules de champs à rechercher. |
|
|
DataSource | Obtient l'objet source de données associé au contrôle propriétaire. (Hérité de DataSourceExpression.) |
|
|
IsTrackingViewState | Obtient une valeur qui indique si un objet expression de source de données effectue le suivi des modifications apportées à son é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 objet DataSourceExpression. (Hérité de ParameterDataSourceExpression.) |
|
|
SearchType | Obtient ou définit la valeur SearchType qui détermine à quel endroit de la chaîne la recherche s'effectue. |
|
|
ViewState | Obtient une instance de la classe StateBag qui contient les informations sur l'état d'affichage actuel. (Hérité de DataSourceExpression.) |
| Nom | Description | |
|---|---|---|
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetQueryable | Applique un objet SearchExpression à l'objet IQueryable spécifié en fonction de l'objet SearchType. (Substitue DataSourceExpression.GetQueryable(IQueryable).) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
LoadViewState | Charge l'état des valeurs de l'objet ParameterDataSourceExpression qui doivent être persistantes. (Hérité de ParameterDataSourceExpression.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
SaveViewState | Enregistre l'état d'affichage actuel de l'objet ParameterDataSourceExpression. (Hérité de ParameterDataSourceExpression.) |
|
|
SetContext | Exécute l'expression à l'aide du contrôle propriétaire, 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 | Suit les modifications d'état d'affichage apportées à l'objet ParameterDataSourceExpression afin de les stocker dans l'objet StateBag pour l'objet. (Hérité de ParameterDataSourceExpression.) |
| Nom | Description | |
|---|---|---|
|
IStateManager.IsTrackingViewState | En cas d'implémentation par une classe, obtient une valeur qui indique si un objet expression de source de données effectue le suivi des modifications de son état d'affichage. (Hérité de DataSourceExpression.) |
|
IStateManager.LoadViewState | En cas d'implémentation par une classe, charge l'état d'affichage précédemment enregistré de l'objet 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 apportées à l'état d'affichage de l'objet DataSourceExpression afin que les modifications puissent être stockées dans l'objet StateBag pour l'objet expression de source de données. (Hérité de DataSourceExpression.) |
| Exception | Condition |
|---|---|
| InvalidOperationException |
La propriété DataFields a la valeur null (Nothing en Visual Basic) |
Le contrôle QueryExtender fournit la capacité à filtrer les données d'une page Web à l'aide de la classe SearchExpression. La classe SearchExpression compare une chaîne spécifiée dans un ou plusieurs champs à une valeur que vous fournissez. L'expression exécute une recherche de type « commence par », « contient » ou « se termine par ». Vous devez spécifier des valeurs pour les propriétés SearchType et DataFields 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 contrôle QueryExtender prend en charge le respect de la casse, vous pouvez activer ou ignorer cette fonction en employant la propriété ComparisonType.
La valeur à rechercher peut être fournie par un contrôle ASP.NET. Pour ce faire, définissez la propriété ControlID de la classe ControlParameter dans l'objet SearchExpression à l'ID d'un contrôle ASP.NET. Par exemple, si la valeur à rechercher est entrée dans une zone de texte, la propriété ControlID doit avoir pour valeur l'ID du contrôle de zone de texte. Vous pouvez utiliser la classe SearchExpression en association avec les autres expressions que QueryExtender prend en charge, telles que le filtre RangeExpression. Par exemple, vous pouvez rechercher des noms de produit qui contiennent la chaîne « thé » et un tarif compris entre 100 et 200.
L'exemple suivant indique comment rechercher des produits dans la colonne Name du tableau Products de la base de données AdventureWorks dont le nom commence par une chaîne spécifiée dans le contrôle SearchTextBox. Le résultat retourné du contrôle LinqDataSource est affiché dans un contrôle GridView.
Cet exemple de code fait partie d'un exemple plus complet fourni dans Procédure pas à pas : filtrage des données dans une page Web à l'aide d'une syntaxe déclarative.
<form id="form1" runat="server">
Search: <asp:TextBox ID="SearchTextBox" runat="server" />
<div>
<asp:Button ID="Button1" runat="server" Text="Search" />
</div>
<asp:LinqDataSource ID="LinqDataSource1"
ContextTypeName="AdventureWorksDataContext"
TableName="Products" runat="server">
</asp:LinqDataSource>
<asp:QueryExtender runat="server"
TargetControlID="LinqDataSource1">
<asp:SearchExpression SearchType="StartsWith" DataFields="Name" >
<asp:ControlParameter ControlID="SearchTextBox" />
</asp:SearchExpression>
</asp:QueryExtender>
<asp:GridView ID="GridView1" runat="server"
DataSourceID="LinqDataSource1" AllowPaging="True" >
</asp:GridView>
</form>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
