EntityDataSource.WhereParameters Propriedade

Definição

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

Obtém a coleção de parâmetros usados para criar a cláusula 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

Valor de Propriedade

ParameterCollection

Os parâmetros usados para criar a cláusula WHERE.

Implementações

WhereParameters
Atributos
BrowsableAttribute PersistenceModeAttribute

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

Tal como o Where método da ObjectQuery<T> classe, os parâmetros podem ser passados ao predicado atribuído à Where propriedade. A WhereParameters propriedade do EntityDataSource controlo especifica um ParameterCollection que contém os parâmetros a fornecer à cláusula WHERE da consulta. A WhereParameters propriedade utiliza argumentos nomeados para se referir aos parâmetros especificados na cadeia fornecida à Where propriedade.

Se a WhereParameters propriedade não estiver definida, não é feita substituição de parâmetros. Todos os nomes de parâmetros na cláusula WHERE precedidos pelo símbolo "@" devem ter um nome correspondente no ParameterCollection. Valores nulos não são permitidos para parâmetros em um ParameterCollection.

Aplica-se a