SqlDataSourceView.FilterExpression Propriedade
Definição
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 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, setPublic Property FilterExpression As StringValor da propriedade
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.