SqlDataSource.FilterParameters Propriedade
Definição
Obtém uma coleção de parâmetros associados a quaisquer espaços reservados para parâmetro na cadeia de caracteres FilterExpression.Gets a collection of parameters that are associated with any parameter placeholders that are in the FilterExpression string.
public:
property System::Web::UI::WebControls::ParameterCollection ^ FilterParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection FilterParameters { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.FilterParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property FilterParameters As ParameterCollection
Valor da propriedade
Um ParameterCollection que contém um conjunto de parâmetros associados a quaisquer espaços reservados para parâmetro encontrados na propriedade FilterExpression.A ParameterCollection that contains a set of parameters associated with any parameter placeholders found in the FilterExpression property.
- Atributos
Exemplos
O exemplo de código a seguir demonstra como recuperar dados do banco de dados Northwind e filtrá-los usando as FilterExpression FilterParameters Propriedades e.The following code example demonstrates how to retrieve data from the Northwind database and filter it using the FilterExpression and FilterParameters properties. A FilterExpression Propriedade do SqlDataSource controle é aplicada sempre que o Select método é executado para recuperar dados.The FilterExpression property of the SqlDataSource control is applied anytime the Select method is executed to retrieve data. Neste exemplo, a FilterExpression propriedade contém um espaço reservado para um parâmetro de filtro, que está contido na FilterParameters coleção.In this example, the FilterExpression property contains a placeholder for a filter parameter, which is contained in the FilterParameters collection. Além disso, o parâmetro Filter é um ControlParameter objeto associado à SelectedValue Propriedade do DropDownList controle.In addition, the filter parameter is a ControlParameter object that is bound to the SelectedValue property of the DropDownList control. Como o DropDownList controle tem sua AutoPostBack propriedade definida como true , qualquer alteração na DropDownList seleção faz com que a página poste informações de volta para o servidor e o GridView controle para reassociar ao controle da fonte de dados com o novo filtro.Because the DropDownList control has its AutoPostBack property set to true, any change in the DropDownList selection causes the page to post information back to the server and the GridView control to rebind to the data source control with the new filter.
<!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
Os parâmetros na FilterParameters coleção são associados a todos os parâmetros especificados na FilterExpression propriedade.The parameters in the FilterParameters collection are associated with any parameters that are specified in the FilterExpression property. Os espaços reservados de parâmetro especificados na FilterExpression propriedade são correspondentes por ordem aos objetos de parâmetro na FilterParameters coleção quando o Select método é chamado.The parameter placeholders that are specified in the FilterExpression property are matched by order to parameter objects in the FilterParameters collection when the Select method is called.
A FilterParameters propriedade recupera a FilterParameters Propriedade contida pelo SqlDataSourceView objeto que está associado ao SqlDataSource controle.The FilterParameters property retrieves the FilterParameters property that is contained by the SqlDataSourceView object that is associated with the SqlDataSource control.
Importante
Os valores são inseridos em parâmetros sem validação, que é uma possível ameaça à segurança.Values are inserted into parameters without validation, which is a potential security threat. Use o Filtering evento para validar valores de parâmetro antes de executar a consulta.Use the Filtering event to validate parameter values before executing the query. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.