EntityDataSource.WhereParameters Propiedad

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.Entity.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene la colección de parámetros que se usan para crear la 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 propiedad

ParameterCollection

Parámetros que se usan para crear la cláusula WHERE.

Implementaciones

WhereParameters

Atributos: BrowsableAttribute PersistenceModeAttribute

Ejemplos

El marcado XML en el ejemplo siguiente, en un archivo. aspx, recupera un valor de un control y lo pasa como un parámetro a la Where propiedad.

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

El ejemplo de XML anterior es el mismo que el ObjectQuery<T> siguiente onlineOrders :

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

Comentarios

Al igual que el Where método de la ObjectQuery<T> clase, los parámetros se pueden pasar al predicado asignado a la Where propiedad. La WhereParameters propiedad del EntityDataSource control especifica un ParameterCollection que contiene los parámetros que se van a proporcionar a la cláusula WHERE de la consulta. La WhereParameters propiedad usa argumentos con nombre para hacer referencia a los parámetros que se especifican en la cadena que se proporciona a la Where propiedad.

Si WhereParameters no se establece la propiedad, no se realiza ninguna sustitución de parámetros. Todos los nombres de parámetro de la cláusula WHERE precedidos por el símbolo " @" deben tener un nombre coincidente en ParameterCollection . No se permiten valores NULL para los parámetros de ParameterCollection .

Se aplica a