SqlDataSource.FilterParameters Propriété

Définition

Obtient une collection de paramètres qui sont associés aux espaces réservés des paramètres dans la chaîne 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

Valeur de propriété

ParameterCollection

ParameterCollection qui contient un jeu de paramètres associé à n'importe quel espace réservé de paramètre trouvé dans la propriété FilterExpression.A ParameterCollection that contains a set of parameters associated with any parameter placeholders found in the FilterExpression property.

Attributs

Exemples

L’exemple de code suivant montre comment récupérer des données de la base de données Northwind et les filtrer à l’aide des FilterExpression FilterParameters Propriétés et.The following code example demonstrates how to retrieve data from the Northwind database and filter it using the FilterExpression and FilterParameters properties. La FilterExpression propriété du SqlDataSource contrôle est appliquée chaque fois que la Select méthode est exécutée pour récupérer des données.The FilterExpression property of the SqlDataSource control is applied anytime the Select method is executed to retrieve data. Dans cet exemple, la FilterExpression propriété contient un espace réservé pour un paramètre de filtre, contenu dans la FilterParameters collection.In this example, the FilterExpression property contains a placeholder for a filter parameter, which is contained in the FilterParameters collection. En outre, le paramètre de filtre est un ControlParameter objet lié à la SelectedValue propriété du DropDownList contrôle.In addition, the filter parameter is a ControlParameter object that is bound to the SelectedValue property of the DropDownList control. Étant donné que la DropDownList propriété du contrôle a la AutoPostBack valeur true , toute modification apportée à la DropDownList sélection provoque la publication des informations sur le serveur et le GridView contrôle pour effectuer une nouvelle liaison au contrôle de source de données avec le nouveau filtre.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>

Remarques

Les paramètres de la FilterParameters collection sont associés à tous les paramètres spécifiés dans la FilterExpression propriété.The parameters in the FilterParameters collection are associated with any parameters that are specified in the FilterExpression property. Les espaces réservés de paramètres qui sont spécifiés dans la FilterExpression propriété sont mis en correspondance par ordre aux objets de paramètre dans la FilterParameters collection lorsque la Select méthode est appelée.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.

La FilterParameters propriété récupère la FilterParameters propriété contenue dans l' SqlDataSourceView objet associé au SqlDataSource contrôle.The FilterParameters property retrieves the FilterParameters property that is contained by the SqlDataSourceView object that is associated with the SqlDataSource control.

Important

Les valeurs sont insérées dans des paramètres sans validation, ce qui constitue une menace potentielle pour la sécurité.Values are inserted into parameters without validation, which is a potential security threat. Utilisez l' Filtering événement pour valider des valeurs de paramètre avant d’exécuter la requête.Use the Filtering event to validate parameter values before executing the query. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.For more information, see Script Exploits Overview.

S’applique à

Voir aussi