EntityDataSource.WhereParameters Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient la collection des 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 de l’exemple suivant, dans un fichier. aspx, récupère une valeur d’un contrôle et la passe 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 le même que celui qui est ObjectQuery<T> nommé onlineOrders :

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

Remarques

À l’instar Where de la méthode de la ObjectQuery<T> classe, les paramètres peuvent être passés au prédicat assigné à 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 dans un ParameterCollection .

S’applique à