LinqDataSource.WhereParameters Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Extensions.dll

Obtiene la colección de parámetros que se utiliza 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

Colección de parámetros que se usan para crear la cláusula Where en la propiedad Where.

Implementaciones

WhereParameters

Atributos

BrowsableAttribute PersistenceModeAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar la WhereParameters colección para crear dinámicamente la cláusula Where. El LinqDataSource control devuelve todos los registros con un valor en la Price columna que es mayor que el valor seleccionado por el usuario en un DropDownList control.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price>@UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > @UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Comentarios

El LinqDataSource control usa parámetros de la WhereParameters colección para crear la cláusula Where en tiempo de ejecución. Los parámetros se agregan a la WhereParameters colección cuando se desea establecer mediante programación una o varias de las condiciones de la cláusula Where. Por ejemplo, puede buscar en una tabla de base de datos registros con un apellido igual al valor de un TextBox control . En ese caso, se agrega un parámetro a la WhereParameters colección para el valor del cuadro de texto.

Si no tiene que establecer un valor en tiempo de ejecución en la cláusula Where, no tiene que usar la WhereParameters colección. Puede definir los campos que se van a recuperar en la Where propiedad . Por ejemplo, para devolver valores de una tabla de base de datos donde LastName es igual a "Adams" en el marcado, establezca la Where propiedad 'LastName = "Adams"' en sin parámetros.

Para establecer valores en la WhereParameters colección, asigne un nombre a cada parámetro y, a continuación, agregue un marcador de posición en la Where propiedad para ese parámetro. En la cláusula Where, antepone cada nombre de parámetro con el símbolo @ .