LinqDataSource.WhereParameters Propriedade

Definição

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

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

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

Implementações

WhereParameters
Atributos
BrowsableAttribute PersistenceModeAttribute

Exemplos

O exemplo seguinte mostra como usar a WhereParameters coleção para criar dinamicamente a cláusula Where. O LinqDataSource controlo devolve todos os registos com um valor na Price coluna que é maior do que o valor selecionado pelo utilizador num DropDownList controlo.

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

Observações

O LinqDataSource controlo utiliza parâmetros na WhereParameters coleção para criar a cláusula Where em tempo de execução. Adiciona-se parâmetros à WhereParameters coleção quando se quer definir programaticamente uma ou mais das condições da cláusula Where. Por exemplo, pode procurar numa tabela de base de dados registos com um apelido igual ao valor de um TextBox controlo. Nesse caso, adiciona-se um parâmetro à WhereParameters coleção para o valor da caixa de texto.

Se não tiver de definir um valor em tempo de execução na cláusula Where, não tem de usar a WhereParameters coleção. Podes definir os campos a recuperar na Where propriedade. Por exemplo, para devolver valores de uma tabela de base de dados onde LastName é igual a "Adams" na marcação, defina a Where propriedade para 'LastName = "Adams"' sem quaisquer parâmetros.

Para definir valores na WhereParameters coleção, atribui-se um nome a cada parâmetro e depois adiciona-se um marcador de posição na Where propriedade para esse parâmetro. Na cláusula Where, introduza cada nome de parâmetro com o símbolo @.

Aplica-se a