Cette documentation est archivée et n’est pas conservée.

LinqDataSource.Where, propriété

Mise à jour : novembre 2007

Obtient ou définit une valeur qui spécifie les conditions qui doivent être remplies pour qu'un enregistrement soit inclus dans les données récupérées.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web.Extensions (dans System.Web.Extensions.dll)

public string Where { get; set; }
/** @property */
public String get_Where()
/** @property */
public  void set_Where(String value)

public function get Where () : String
public function set Where (value : String)
<asp:LinqDataSource Where="String" />

Valeur de propriété

Type : System.String

Chaîne utilisée pour créer la clause Where.

Vous utilisez la propriété Where pour spécifier les conditions permettant de retourner l'enregistrement à partir d'une requête. Vous utilisez des opérateurs de comparaison pour tester la valeur d'une propriété. Lorsque vous spécifiez plusieurs conditions dans la propriété Where, vous devez définir la relation entre les conditions à l'aide des opérateurs logiques AND et OR. Utilisez && ou and pour l'opérateur logique AND. Utilisez || ou or pour l'opérateur logique OR.

Lorsque vous testez une propriété par rapport à une valeur de chaîne dans le balisage, vous devez mettre la condition entre guillemets simples et la valeur de chaîne entre guillemets doubles. Par exemple, pour retourner des enregistrements dans lesquels la propriété Category équivaut à « Sports » dans le balisage, affectez la valeur 'Category = "Sports"' à la propriété Where.

Vous pouvez filtrer les données selon les valeurs statiques que vous définissez lors de la création de la page Web ou selon les valeurs dynamiques évaluées au moment de l'exécution. Lorsque vous utilisez des valeurs statiques, vous incluez la valeur statique dans la propriété Where. Par exemple, affectez la valeur Price > 50 à la propriété Where pour récupérer des enregistrements avec une valeur Price supérieure à 50. Lorsque vous définissez des valeurs au moment de l'exécution, vous incluez un paramètre nommé dans la propriété Where qui agit comme un espace réservé pour la valeur. Vous ajoutez ensuite un paramètre avec le nom correspondant à la collection WhereParameters. Vous pouvez également affecter la valeur true à la propriété AutoGenerateWhereClause et définir les paramètres souhaités dans la collection WhereParameters. Lorsque la propriété AutoGenerateWhereClause est true, vous ne devez pas inclure les paramètres nommés dans la propriété Where. Dans ce cas, le contrôle LinqDataSource génère automatiquement la clause Where à partir des paramètres de la propriété WhereParameters.

Pour plus d'informations sur le filtrage des données, consultez Procédure pas à pas : sélection et filtrage d'un sous-ensemble de données avec les contrôles LinqDataSource et GridView.

L'exemple suivant indique comment filtrer les données retournées à partir d'une requête selon une condition statique.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>


L'exemple suivant indique comment filtrer les données selon une valeur fournie par l'utilisateur au moment de l'exécution.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price>@UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>


Windows Vista, Windows XP SP2, Windows Server 2003

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5
Afficher: