LinqDataSource.WhereParameters Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ParameterCollection

Uma coleção dos parâmetros usados para criar a cláusula Where na propriedade Where.

Implementações

WhereParameters

Atributos: BrowsableAttribute PersistenceModeAttribute

Exemplos

O exemplo a seguir mostra como usar a WhereParameters coleção para criar dinamicamente a cláusula Where. O LinqDataSource controle retorna todos os registros com um valor na Price coluna maior que o valor selecionado pelo usuário em um DropDownList controle.

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

Comentários

O LinqDataSource controle usa parâmetros na WhereParameters coleção para criar a cláusula Where em tempo de execução. Você adiciona parâmetros à WhereParameters coleção quando deseja definir programaticamente uma ou mais das condições na cláusula Where. Por exemplo, você pode pesquisar uma tabela de banco de dados em busca de registros com um sobrenome igual ao valor de um TextBox controle. Nesse caso, você adiciona um parâmetro à WhereParameters coleção para o valor da caixa de texto.

Se você não precisar definir um valor em tempo de execução na cláusula Where, não precisará usar a WhereParameters coleção. Você pode definir os campos a serem recuperados na Where propriedade. Por exemplo, para retornar valores de uma tabela de banco de dados em que LastName é igual a "Adams" na marcação, defina a Where propriedade 'LastName = "Adams"' como sem parâmetros.

Para definir valores na WhereParameters coleção, atribua um nome a cada parâmetro e, em seguida, adicione um espaço reservado na Where propriedade para esse parâmetro. Na cláusula Where, prefira cada nome de parâmetro com o símbolo @.

Aplica-se a

Partilhar via