EntityDataSource.WhereParameters Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtient la collection de paramètres utilisés 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

Paramètres utilisés pour créer la clause WHERE.

Implémente

WhereParameters

Attributs

BrowsableAttribute PersistenceModeAttribute

Exemples

Le balisage XML dans l’exemple suivant, dans un fichier .aspx, récupère une valeur d’un contrôle et le transmet en tant que paramètre à la Where propriété.

<asp:EntityDataSource ID="SalesOrderHeader" runat="server"
  ConnectionString="name=AdventureWorksEntities"
  DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
  EnableInsert="True" EnableUpdate="True" EntitySetName="SalesOrderHeader"
  EntityTypeFilter="" OrderBy="it.TotalDue DESC" Select=""
   Where="it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost">
  <WhereParameters>
    <asp:ControlParameter ControlID="costLimit" DbType="Int32"
      DefaultValue="2500" Name="ordercost" PropertyName="Text" />
  </WhereParameters>
</asp:EntityDataSource>

L’exemple XML précédent est identique au nom onlineOrderssuivant ObjectQuery<T> :

ObjectQuery<SalesOrderHeader> onlineOrders =
      context.SalesOrderHeader
       .Where("it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost",
         new ObjectParameter("ordercost", orderCost))
        .OrderBy("it.TotalDue DESC");

Remarques

Comme la Where méthode de la ObjectQuery<T> classe, les paramètres peuvent être passés au prédicat affecté à la Where propriété. La WhereParameters propriété du EntityDataSource contrôle spécifie un ParameterCollection qui contient les paramètres à fournir à la clause WHERE de la requête. La WhereParameters propriété utilise des arguments nommés pour faire référence aux paramètres spécifiés dans la chaîne fournie à la Where propriété.

Si la WhereParameters propriété n’est pas définie, aucune substitution de paramètre n’est effectuée. Tous les noms de paramètres de la clause WHERE précédés du symbole «@" doivent avoir un nom correspondant dans le ParameterCollection. Les valeurs Null ne sont pas autorisées pour les paramètres d’un ParameterCollection.