Partilhar via


SqlDataSourceView.FilterExpression Propriedade

Definição

Obtém ou define uma expressão de filtragem que é aplicada quando o método Select é chamado.

public:
 property System::String ^ FilterExpression { System::String ^ get(); void set(System::String ^ value); };
public string FilterExpression { get; set; }
member this.FilterExpression : string with get, set
Public Property FilterExpression As String

Valor da propriedade

String

Uma cadeia de caracteres que representa uma expressão de filtragem aplicada quando os dados são recuperados usando o método Select(DataSourceSelectArguments).

Exceções

A propriedade FilterExpression foi definida quando a SqlDataSource está no modo DataReader.

Exemplos

O exemplo de código a seguir demonstra como recuperar dados do banco de dados Northwind e filtre-os usando as propriedades e FilterParameters o FilterExpression uso. A FilterExpression propriedade do SqlDataSource controle é aplicada sempre que o Select método é executado para recuperar dados. Neste exemplo, a FilterExpression propriedade contém um espaço reservado para um parâmetro de filtro, que está contido na FilterParameters coleção. Neste exemplo, o parâmetro de filtro é um ControlParameter objeto associado à SelectedValue propriedade do DropDownList controle. Como o DropDownList controle tem sua AutoPostBack propriedade definida como true, qualquer alteração na DropDownList seleção faz com que a página seja postada no servidor e o GridView controle seja rebinado ao controle da fonte de dados com o novo filtro.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected="True">Sales Representative</asp:ListItem>
                <asp:ListItem>Sales Manager</asp:ListItem>
                <asp:ListItem>Vice President, Sales</asp:ListItem>
            </asp:DropDownList></p>

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource>

            <p><asp:GridView
                id="GridView1"
                runat="server"
                DataSourceID="SqlDataSource1"
                AutoGenerateColumns="False">
                <columns>
                    <asp:BoundField Visible="False" DataField="EmployeeID" />
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                </columns>
            </asp:GridView></p>

        </form>
    </body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected="True">Sales Representative</asp:ListItem>
                <asp:ListItem>Sales Manager</asp:ListItem>
                <asp:ListItem>Vice President, Sales</asp:ListItem>
            </asp:DropDownList></p>

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource>

            <p><asp:GridView
                id="GridView1"
                runat="server"
                DataSourceID="SqlDataSource1"
                AutoGenerateColumns="False">
                <columns>
                    <asp:BoundField Visible="False" DataField="EmployeeID" />
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                </columns>
            </asp:GridView></p>

        </form>
    </body>
</html>

Comentários

A sintaxe usada para a FilterExpression propriedade é uma sintaxe estilo cadeia de caracteres de formato. Você pode incluir parâmetros na FilterExpression propriedade. Se o tipo do parâmetro for cadeia de caracteres ou caracteres, coloque o parâmetro entre aspas simples. As aspas não serão necessárias se o parâmetro for um tipo numérico.

A FilterParameters coleção contém os parâmetros que são avaliados para os espaços reservados encontrados na FilterExpression propriedade.

O SqlDataSource controle dá suporte à filtragem de dados somente quando estiver no DataSet modo.

O valor da FilterExpression propriedade é armazenado no estado de exibição.

Importante

Você deve validar qualquer valor de parâmetro de filtro recebido do cliente. O runtime simplesmente substitui o valor do parâmetro na expressão de filtro e aplica-o ao DataView objeto retornado pelo Select método. Se você estiver usando a FilterExpression propriedade como uma medida de segurança para limitar o número de itens retornados, você deverá validar os valores de parâmetro antes que a filtragem ocorra.

Aplica-se a

Confira também