Partager via

SqlDataSourceView.FilterParameters Propriété

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient une collection de paramètres associés à tous les espaces réservés de paramètres dans la FilterExpression chaîne.

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

Qui ParameterCollection contient un ensemble de paramètres associés à tous les espaces réservés de paramètres trouvés dans la FilterExpression propriété.

Attributs
PersistenceModeAttribute

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 propriétés et FilterParameters des FilterExpression propriétés. 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. Dans cet exemple, la FilterExpression propriété contient un espace réservé pour un paramètre de filtre, qui est contenu dans la FilterParameters collection. En outre, le paramètre de filtre est un ControlParameter objet lié à la SelectedValue propriété du DropDownList contrôle. Étant donné que le DropDownList contrôle a sa AutoPostBack propriété définie truesur , toute modification de la DropDownList sélection entraîne la publication d’informations sur la page sur le serveur et le GridView contrôle pour se reconnecter au contrôle de source de données avec le nouveau filtre.

<!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é. Les espaces réservés de paramètre spécifiés dans le FilterExpression fichier sont évalués par ordre et mis en correspondance avec les objets de paramètres de la FilterParameters collection lorsque la Select méthode est appelée.

Important

Vous devez valider toute valeur de paramètre de filtre que vous recevez du client. Le runtime remplace simplement la valeur du paramètre dans l’expression de filtre et l’applique à l’objet DataView retourné par la Select méthode. Si vous utilisez la FilterExpression propriété comme mesure de sécurité pour limiter le nombre d’éléments retournés, vous devez valider les valeurs de paramètre avant le filtrage.

S’applique à

Voir aussi