SqlDataSource.FilterExpression Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define uma expressão de filtragem que é aplicada quando o Select(DataSourceSelectArguments) método é 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 de Propriedade
Uma cadeia que representa uma expressão de filtragem aplicada quando os dados são recuperados usando o Select(DataSourceSelectArguments) método.
Exceções
A FilterExpression propriedade foi definida e está SqlDataSource em DataReader modo.
Exemplos
O exemplo de código seguinte demonstra como recuperar dados da base de dados da Northwind e filtrá-los usando uma FilterExpression string e a FilterParameters coleção. A FilterExpression propriedade é aplicada sempre que o Select método é executado para recuperar dados. Neste exemplo, o FilterExpression contém um marcador para um parâmetro de filtro, que está contido na FilterParameters coleção. Além disso, o parâmetro filtro é um ControlParameter objeto que está ligado à SelectedValue propriedade do DropDownList controlo. Como o DropDownList controlo tem a sua AutoPostBack propriedade definida como true, qualquer alteração na seleção DropDownList do controlo faz com que a página envie informação de volta ao servidor e o GridView controlo seja reatribuído ao controlo de 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>
Observações
O valor da FilterExpression propriedade é uma expressão de cadeia de formato (uma cadeia processada pelo String.Format método) que utiliza os valores da FilterExpression coleção para quaisquer parâmetros de substituição incluídos na cadeia. A sintaxe da expressão do filtro é a mesma que é aceite pela RowFilter propriedade, porque a expressão do filtro é aplicada à RowFilter propriedade do DataView objeto que é devolvida ao executar o Select método. Para obter mais informações, veja Expression.
Se adicionar parâmetros à FilterParameters coleção, também pode incluir marcadores de espaço para a cadeia de formatos (por exemplo, "{0}") na expressão para substituir os valores dos parâmetros). Os marcadores de posição são substituídos de acordo com o índice do parâmetro na FilterParameters coleção. Se um objeto na FilterParameters coleção for null, o objeto será substituído por uma cadeia vazia.
Pode incluir parâmetros na FilterExpression propriedade. Se o parâmetro for um tipo de cadeia ou carácter, inclua o parâmetro entre aspas simples. Não são necessárias aspas, se o parâmetro for de tipo numérico. A FilterParameters coleção contém os parâmetros que são avaliados para os marcadores de posição encontrados na FilterExpression propriedade.
O SqlDataSource controlo suporta filtragem de dados apenas quando está no DataSet modo.
A FilterExpression propriedade delega à FilterExpression propriedade do SqlDataSourceView objeto associada ao SqlDataSource controlo.
