LinqDataSource.WhereParameters Propriété

Définition

Obtient la collection de paramètres utilisée pour créer la clause Where.Gets the collection of parameters that is used to create the Where clause.

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; }
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property WhereParameters As ParameterCollection

Valeur de propriété

Collection des paramètres utilisés pour créer la clause Where dans la propriété Where.A collection of the parameters that are used to create the Where clause in the Where property.

Implémente

Attributs

Exemples

L’exemple suivant montre comment utiliser la collection WhereParameters pour créer dynamiquement la clause WHERE.The following example shows how to use the WhereParameters collection to dynamically create the Where clause. Le contrôle LinqDataSource retourne tous les enregistrements dont la valeur est comprise dans la colonne Price qui est supérieure à la valeur sélectionnée par l’utilisateur dans un contrôle DropDownList.The LinqDataSource control returns all the records with a value in the Price column that is greater than the value selected by the user in a DropDownList control.

<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 contrôle LinqDataSource utilise des paramètres dans la collection WhereParameters pour créer la clause WHERE au moment de l’exécution.The LinqDataSource control uses parameters in the WhereParameters collection to create the Where clause at run time. Vous ajoutez des paramètres à la collection WhereParameters lorsque vous souhaitez définir par programmation une ou plusieurs des conditions dans la clause WHERE.You add parameters to the WhereParameters collection when you want to programmatically set one or more of the conditions in the Where clause. Par exemple, vous pouvez rechercher dans une table de base de données des enregistrements dont le nom de famille est égal à la valeur d’un contrôle de TextBox.For example, you might search a database table for records with a last name equal to the value of a TextBox control. Dans ce cas, vous ajoutez un paramètre à la collection WhereParameters pour la valeur de la zone de texte.In that case, you add a parameter to the WhereParameters collection for the text box value.

Si vous n’avez pas besoin de définir une valeur au moment de l’exécution dans la clause WHERE, vous n’êtes pas obligé d’utiliser la collection WhereParameters.If you do not have to set a value at run time in the Where clause, you do not have to use the WhereParameters collection. Vous pouvez définir les champs à récupérer dans la propriété Where.You can define the fields to retrieve in the Where property. Par exemple, pour retourner des valeurs à partir d’une table de base de données où LastName est égal à « Adams » dans le balisage, affectez à la propriété Where la valeur 'LastName = "Adams"' sans aucun paramètre.For example, to return values from a database table where LastName equals "Adams" in markup, set the Where property to 'LastName = "Adams"' without any parameters.

Pour définir des valeurs dans la collection WhereParameters, vous affectez un nom à chaque paramètre, puis vous ajoutez un espace réservé dans la propriété Where de ce paramètre.To set values in the WhereParameters collection, you assign a name to each parameter and then add a placeholder in the Where property for that parameter. Dans la clause WHERE, faites précéder chaque nom de paramètre du symbole @.In the Where clause, preface each parameter name with the @ symbol.

S’applique à