Share via

Ajouter une clause WHERE, boîte de dialogue - SqlDataSource

  • Article

Mise à jour : novembre 2007

La boîte de dialogue Ajouter une clause WHERE vous permet de définir plus précisément une instruction SELECT d'une source de données SQL en spécifiant des conditions de recherche qui limitent les lignes retournées.

Vous pouvez ajouter une ou plusieurs conditions de recherche à une clause WHERE. Pour chaque condition de recherche, vous pouvez spécifier un littéral ou une valeur paramétrée. Les valeurs paramétrées vous permettent de créer une liaison à des variables d'application, des choix et identités de l'utilisateur et d'autres données.

Tâches

Éléments d'interface

  • Colonne
    Cet élément spécifie la colonne de données à utiliser dans la condition de recherche de la clause WHERE. La valeur sélectionnée dans la liste déroulante devient la partie gauche de la condition de recherche.

  • Opérateur
    Cet élément spécifie l'opérateur à utiliser dans la condition de recherche de la clause WHERE. Les opérateurs que vous pouvez sélectionner dépendent de la définition de la colonne de données. Pour les colonnes de données définies comme entiers, les choix possibles sont les suivants : égal à (=), inférieur à (<), supérieur à (>), inférieur ou égal à, (<=) supérieur ou égal à (>=) ou différent de (<>). Pour les colonnes de données qui autorisent des valeurs Null, vous pouvez également choisir les options IS NULL et IS NOT NULL. Pour les colonnes de données qui sont définies comme types de données caractères, LIKE et NOT LIKE sont disponibles.

  • Source
    Cet élément spécifie la source à utiliser dans la condition de recherche de la clause WHERE. La source sélectionnée devient la partie droite de la condition de recherche. Les options possibles sont les suivantes : None, Control, Cookie, Form, Profile, QueryString et Session.

    La sélection de None indique qu'une valeur littérale sera utilisée dans la condition de recherche. Dans ce cas, l'élément Propriétés du paramètre affichera uniquement un champ Valeur.

    La sélection de l'une des autres valeurs de Source indique qu'une valeur paramétrée sera utilisée dans la condition de recherche. Dans ce cas, l'élément Propriétés du paramètre affichera deux champs.

  • Propriétés du paramètre
    Cet élément vous permet de définir les propriétés de paramètre de la condition de recherche. Ce qui apparaît dans l'élément Propriétés du paramètre dépend de la Source sélectionnée, comme affiché dans le tableau suivant.

    Source

    Propriétés du paramètre

    None

    Valeur

    Control

    ID de contrôle

    Valeur par défaut

    Cookie

    Nom du cookie

    Valeur par défaut

    Form

    Champ Form

    Valeur par défaut

    Profil

    Nom du profil

    Valeur par défaut

    QueryString

    Champ QueryString

    Valeur par défaut

    Session

    Champ Session

    Valeur par défaut

    Chaque source entraîne un contrôle Parameter différent dans le ParameterCollection du contrôle SqlDataSource, comme indiqué dans le tableau suivant.

    Source

    Paramètre résultant

    None

    Parameter

    Control

    ControlParameter

    Cookie

    CookieParameter

    Form

    FormParameter

    Champ

    ProfileParameter

    QueryString

    QueryStringParameter

    Session

    SessionParameter

  • Expression SQL
    Cet élément affiche le résultat de la condition de recherche qui est configurée actuellement.

  • Valeur
    Cet élément affiche la valeur que la condition de recherche doit satisfaire. L'élément Value correspond à la propriété DefaultValue du contrôle Parameter.

  • Clause WHERE
    Cet élément affiche le résultat de la clause WHERE composée de conditions de recherche. Utilisez les boutons Ajouter et Supprimer pour ajouter une nouvelle condition de recherche ou supprimer une condition de recherche existante, respectivement.

  • Ajouter
    Le bouton Ajouter ajoute la condition de recherche configurée à la clause WHERE. Le bouton Ajouter est activé uniquement si la condition de recherche est totalement définie.

  • Supprimer
    Le bouton Supprimer supprime la condition de recherche sélectionnée dans l'élément clause WHERE. Le bouton Supprimer est activé uniquement si la clause WHERE contient au moins une condition de recherche.

Voir aussi

Référence

Configurer la source de données, boîte de dialogue - SqlDataSource

Ajouter une clause ORDER BY, boîte de dialogue - SqlDataSource

Options de génération SQL avancées, boîte de dialogue - SqlDataSource