EntityDataSource.Where Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtient ou définit l'expression Entity SQL qui spécifie la manière de filtrer les résultats de la requête.

public:
 property System::String ^ Where { System::String ^ get(); void set(System::String ^ value); };

public string Where { get; set; }

member this.Where : string with get, set

Public Property Where As String

Valeur de propriété

String

Clause WHERE.

Implémente

Where

Exemples

Le balisage XML dans l’exemple suivant, dans un fichier .aspx, récupère une valeur à partir d’un contrôle et la 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 le même que le suivant 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

La Where propriété du EntityDataSource contrôle est une chaîne qui représente une clause WHERE qui est le prédicat d’une requête Entity SQL. Cette chaîne est passée, sans modification, à un ObjectQuery<T> qui est exécuté par Entity Framework. Cette requête est la source des données réglementées par le EntityDataSource contrôle. La chaîne fournie à la Where propriété utilise le même format que la chaîne passée à la Where méthode de ObjectQuery<T>. Pour obtenir des exemples d’utilisation de la clause WHERE pour filtrer une requête, consultez Guide pratique pour filtrer les données.

Pour filtrer les résultats de la requête en assimilant une propriété de type d’entité à une expression, consultez les informations relatives à la AutoGenerateWhereClause propriété .