LinqDataSource.WhereParameters Propriété

  • Référence

Définition

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

Obtient la collection de paramètres utilisée pour créer la clause Where.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ WhereParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection WhereParameters { get; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property WhereParameters As ParameterCollection

Valeur de propriété

ParameterCollection

Collection des paramètres utilisés pour créer la clause Where dans la propriété Where.

Implémente

WhereParameters
Attributs
BrowsableAttribute PersistenceModeAttribute

Exemples

L’exemple suivant montre comment utiliser la WhereParameters collection pour créer dynamiquement la clause Where. Le LinqDataSource contrôle retourne tous les enregistrements dont la Price valeur est supérieure à la valeur sélectionnée par l’utilisateur dans un DropDownList contrôle.

<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>

<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>

Remarques

Le LinqDataSource contrôle utilise des paramètres dans la WhereParameters collection pour créer la clause Where au moment de l’exécution. Vous ajoutez des paramètres à la WhereParameters collection lorsque vous souhaitez définir par programmation une ou plusieurs des conditions dans la clause Where. Par exemple, vous pouvez rechercher dans une table de base de données des enregistrements dont le nom est égal à la valeur d’un TextBox contrôle. Dans ce cas, vous ajoutez un paramètre à la WhereParameters collection pour la valeur de la zone de texte.

Si vous n’avez pas besoin de définir une valeur au moment de l’exécution dans la clause Where, vous n’avez pas besoin d’utiliser la WhereParameters collection. Vous pouvez définir les champs à récupérer dans la Where propriété. Par exemple, pour retourner des valeurs à partir d’une table de base de données où LastName est égal à « Adams » dans le balisage, définissez la Where propriété 'LastName = "Adams"' sur sans aucun paramètre.

Pour définir des valeurs dans la WhereParameters collection, vous attribuez un nom à chaque paramètre, puis ajoutez un espace réservé dans la Where propriété pour ce paramètre. Dans la clause Where, préfacez chaque nom de paramètre avec le symbole @.

S’applique à