Éditeur d'expressions - LinqDataSource

Mise à jour : novembre 2007

La boîte de dialogue Éditeur d'expressions vous permet de définir les expressions Where, Order by, Group by ou Select pour un contrôle LinqDataSource. Vous pouvez ajouter des paramètres utilisés dans ces expressions. Lors de la définition de l'expression Where ou Order By, vous pouvez autoriser le contrôle LinqDataSource à générer automatiquement l'expression, ou vous pouvez créer l'expression manuellement. La boîte de dialogue Éditeur d'expressions vous permet également d'ajouter des paramètres pour les opérations d'insertion, de mise à jour ou de suppression.

Vous accédez à cette boîte de dialogue en sélectionnant le bouton de sélection (.) dans la fenêtre Propriétés pour un des éléments suivants :

L'interface utilisateur de l' Éditeur d'expressions change selon l'expression définie. Par exemple, l'élément pour définir l'expression manuellement est nommé Expression Where ou Expression Order By, selon le contexte.

Vous pouvez également accéder à cette boîte de dialogue en cliquant sur le bouton Where ou Order By dans la boîte de dialogue Configurer la source de données - LinqDataSource si vous avez autorisé le contrôle LinqDataSource à générer automatiquement l'expression. Elle est également affichée si vous avez affecté précédemment à l'expression une expression personnalisée qui ne peut pas être prise en charge dans les autres boîtes de dialogue. Vous affectez à la propriété AutoGenerateWhereClause la valeur true pour générer automatiquement la clause Where. Vous affectez à la propriété AutoGenerateOrderByClause la valeur true pour générer automatiquement la clause Order By.

  • Générer automatiquement l'expression en fonction des paramètres donnés
    Spécifie si le contrôle LinqDataSource génère l'expression Where ou Order By. L'expression générée inclut les paramètres définis dans la collection WhereParameters ou la collection OrderByParameters. Pour plus d'informations sur la façon dont le contrôle LinqDataSource génère l'expression, consultez la propriété AutoGenerateWhereClause ou la propriété AutoGenerateOrderByClause.

  • Expression
    Vous permet de créer manuellement l'expression Where, Order By, Group By ou Select. Lorsque vous définissez l'expression Where ou Order By et que la case à cocher Générer automatiquement l'expression en fonction des paramètres donnés est activée, cet élément est désactivé. Si vous activez la case à cocher, toute expression entrée sera effacée. Pour plus d'informations sur la définition de l'expression Where ou Order By, consultez la propriété Where ou la propriété OrderBy.

  • Paramètres
    Affiche les paramètres existants et vous permet d'ajouter de nouveaux paramètres. Le tableau indique le nom du paramètre et la syntaxe utilisée pour récupérer la valeur du paramètre. Cliquez sur Ajouter un paramètre pour ajouter un nouveau paramètre.

  • Source du paramètre
    Spécifie la source à utiliser pour un paramètre. Les options possibles sont les suivantes : None, Control, Cookie, Form, Profile, QueryString et Session.

    Chaque source produit un contrôle Parameter différent dans la collection de paramètres du contrôle LinqDataSource, comme indiqué dans le tableau suivant.

    Source

    Paramètre résultant

    Aucun

    Parameter

    Contrôle

    ControlParameter

    Cookie

    CookieParameter

    Formulaire

    FormParameter

    Champ

    ProfileParameter

    QueryString

    QueryStringParameter

    Session

    SessionParameter

    Pour plus d'informations, consultez Utilisation de paramètres avec des contrôles de source de données.

    La source que vous sélectionnez détermine les champs disponibles pour définir le paramètre, comme indiqué dans le tableau suivant :

    Source du paramètre

    Propriétés du paramètre

    Aucune

    Valeur

    Contrôle

    ID de contrôle

    Valeur par défaut

    Cookie

    Nom du cookie

    Valeur par défaut

    Formulaire

    Champ Form

    Valeur par défaut

    Profil

    Nom de la propriété

    Valeur par défaut

    QueryString

    Champ QueryString

    Valeur par défaut

    Session

    Champ Session

    Valeur par défaut

Voir aussi

Concepts

Vue d'ensemble du contrôle serveur Web LinqDataSource

Référence

AutoGenerateWhereClause

AutoGenerateOrderByClause