EntityDataSource.Where Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.Entity.dll

Obtém ou define a expressão SQL Entity que especifica como filtrar os resultados da consulta.

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

Valor de Propriedade

String

A cláusula WHERE.

Implementações

Where

Exemplos

A marcação XML no exemplo seguinte, num ficheiro .aspx, recupera um valor de um controlo e passa-o como parâmetro para a Where propriedade.

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

O exemplo anterior de XML é o mesmo que o seguinte ObjectQuery<T> , nomeado onlineOrders:

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

Observações

A Where propriedade do EntityDataSource controlo é uma cadeia que representa uma cláusula WHERE que é o predicado de uma consulta SQL da Entidade. Esta cadeia é passada, sem modificações, para uma ObjectQuery<T> que é executada pelo Entity Framework. Esta consulta é a fonte dos dados regulados pelo EntityDataSource controlo. A cadeia fornecida à Where propriedade usa o mesmo formato da cadeia que é passada ao Where método de ObjectQuery<T>. Para exemplos de como usar a cláusula WHERE para filtrar uma consulta, veja Como: Filtrar Dados.

Para filtrar os resultados da consulta equiparando uma propriedade de tipo de entidade a uma expressão, consulte informações sobre a AutoGenerateWhereClause propriedade.

Aplica-se a