Фильтрация данных с помощью элементов управления источниками данных
Обновлен: Ноябрь 2007
Элементы управления источниками данных предоставляют несколько служб данных, облегчающих добавление дополнительных возможностей в приложения. В их число входит фильтрация данных, основанная на указанном условии поиска. Фильтрация особенно удобна при работе с кэшированными данными, поскольку можно предоставить возможности поиска, не перезапуская запросы и не вызывая методы для чтения данных.
Для фильтрации данных элемент управления источником данных должен быть настроен следующим образом:
Свойство DataSourceMode элементов управления SqlDataSource или AccessDataSource должно иметь значение DataSet.
Базовый исходный объект элемента управления ObjectDataSource должен возвращать объект DataSet или DataTable.
При использовании элемента управления XmlDataSource можно фильтровать данные с помощью запросов XPath. Дополнительные сведения см. в разделе Фильтрация данных с помощью элемента управления XmlDataSource.
Задание критерия фильтра
Фильтр, применяемый к данным, возвращенным элементом управления ObjectDataSource, SqlDataSource или AccessDataSource задается путем присвоения значения свойству FilterExpression элемента управления источником данных. Синтаксис для критерия фильтра основан на синтаксисе свойства Expression класса DataColumn. Критерий фильтра применяется при вызове метода Select элемента управления источником данных.
Предоставление параметров фильтра
Можно предоставить параметризованный критерий фильтра для элемента управления ObjectDataSource, SqlDataSource или AccessDataSource, позволяющий предоставлять значения фильтра во время выполнения, не создавая код для явного задания свойства FilterExpression. Параметры критерия фильтра задаются с помощью коллекции FilterParameters элемента управления источником данных. Параметры могут извлекать данные из элементов управления, объекта QueryString, состояния сеанса, свойств профиля пользователя и т. д. Дополнительные сведения о типах параметров, которые можно использовать в коллекции FilterParameters см. в описании Использование параметров с элементами управления источников данных.
В критерии фильтра создаются местозаполнители, соответствующие элементам в коллекции FilterParameters элемента управления источником данных. Местозаполнители пронумерованы и 0 соответствует первому параметру в коллекции. Можно указать местозаполнитель в критерии фильтра, расположив номер параметра фильтра в знаках «{» и «}», как показано в следующем примере.
Country = '{0}' AND LastName LIKE '{1}'
.gif "Примечание о безопасности") Примечание о безопасности. |
|---|
Поскольку значения из коллекции FilterParameters подставляются в строку FilterExpression без кодирования, перед применением фильтра следует проверять все значения параметра фильтра. Можно использовать событие Filtering элемента управления источником данных для доступа к значениям параметра фильтра и для их проверки перед применением фильтра. |
В следующем примере показан элемент управления SqlDataSource с именем EmployeeDetailsSqlDataSource, включающий параметры фильтра. Значения параметра, используемые в свойстве FilterExpression, заполняются во время выполнения из значений свойств элементов управления в другой части страницы.
<%@ Page language="VB" %>
<!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>Northwind Employees</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Northwind Employees</h3>
<table cellspacing="10">
<tr>
<td valign="top">
<table border="0">
<tr>
<td valign="top">Country</td>
<td><asp:DropDownList runat="server" id="CountryListBox" AppendDataBoundItems="True"
DataSourceID="CountrySqlDataSource"
DataTextField="Country" DataValueField="Country" >
<asp:ListItem Selected="True" Value="" >(Show All)</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
<tr>
<td>Last Name</td>
<td><asp:TextBox runat="server" id="LastNameTextBox" Text="*" /></td>
</tr>
<tr>
<td></td>
<td><asp:Button runat="server" id="FilterButton" Text="Filter Results" /></td>
</tr>
</table>
</td>
<td valign="top">
<asp:GridView ID="EmployeesGridView"
DataSourceID="EmployeeDetailsSqlDataSource"
AutoGenerateColumns="false"
AllowSorting="True"
DataKeyNames="EmployeeID"
Gridlines="Both"
RunAt="server">
<HeaderStyle backcolor="Navy"
forecolor="White"/>
<RowStyle backcolor="White"/>
<AlternatingRowStyle backcolor="LightGray"/>
<EditRowStyle backcolor="LightCyan"/>
<Columns>
<asp:BoundField DataField="EmployeeID" HeaderText="Employee ID" ReadOnly="true"/>
<asp:BoundField DataField="FirstName" HeaderText="First Name"/>
<asp:BoundField DataField="LastName" HeaderText="Last Name"/>
<asp:BoundField DataField="Country" HeaderText="Country"/>
</Columns>
</asp:GridView>
</td>
</tr>
</table>
<asp:SqlDataSource ID="CountrySqlDataSource"
SelectCommand="SELECT DISTINCT Country FROM Employees"
EnableCaching="True"
CacheDuration="60"
ConnectionString="<%$ ConnectionStrings:NorthwindConnection %>"
RunAt="server" />
<asp:SqlDataSource ID="EmployeeDetailsSqlDataSource"
SelectCommand="SELECT EmployeeID, LastName, FirstName, Country FROM Employees"
EnableCaching="True"
CacheDuration="60"
ConnectionString="<%$ ConnectionStrings:NorthwindConnection %>"
FilterExpression="Country LIKE '{0}' AND LastName LIKE '{1}'"
RunAt="server">
<FilterParameters>
<asp:ControlParameter ControlID="CountryListBox" PropertyName="SelectedValue" />
<asp:ControlParameter ControlID="LastNameTextBox" PropertyName="Text" />
</FilterParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="C#" %>
<!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>Northwind Employees</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Northwind Employees</h3>
<table cellspacing="10">
<tr>
<td valign="top">
<table border="0">
<tr>
<td valign="top">Country</td>
<td><asp:DropDownList runat="server" id="CountryListBox" AppendDataBoundItems="True"
DataSourceID="CountrySqlDataSource"
DataTextField="Country" DataValueField="Country" >
<asp:ListItem Selected="True" Value="" >(Show All)</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
<tr>
<td>Last Name</td>
<td><asp:TextBox runat="server" id="LastNameTextBox" Text="*" /></td>
</tr>
<tr>
<td></td>
<td><asp:Button runat="server" id="FilterButton" Text="Filter Results" /></td>
</tr>
</table>
</td>
<td valign="top">
<asp:GridView ID="EmployeesGridView"
DataSourceID="EmployeeDetailsSqlDataSource"
AutoGenerateColumns="false"
AllowSorting="true"
DataKeyNames="EmployeeID"
Gridlines="Both"
RunAt="server">
<HeaderStyle backcolor="Navy"
forecolor="White"/>
<RowStyle backcolor="White"/>
<AlternatingRowStyle backcolor="LightGray"/>
<EditRowStyle backcolor="LightCyan"/>
<Columns>
<asp:BoundField DataField="EmployeeID" HeaderText="Employee ID" ReadOnly="true"/>
<asp:BoundField DataField="FirstName" HeaderText="First Name"/>
<asp:BoundField DataField="LastName" HeaderText="Last Name"/>
<asp:BoundField DataField="Country" HeaderText="Country"/>
</Columns>
</asp:GridView>
</td>
</tr>
</table>
<asp:SqlDataSource ID="CountrySqlDataSource"
SelectCommand="SELECT DISTINCT Country FROM Employees"
EnableCaching="True"
CacheDuration="60"
ConnectionString="<%$ ConnectionStrings:NorthwindConnection %>"
RunAt="server" />
<asp:SqlDataSource ID="EmployeeDetailsSqlDataSource"
SelectCommand="SELECT EmployeeID, LastName, FirstName, Country FROM Employees"
EnableCaching="True"
CacheDuration="60"
ConnectionString="<%$ ConnectionStrings:NorthwindConnection %>"
FilterExpression="Country LIKE '{0}' AND LastName LIKE '{1}'"
RunAt="server">
<FilterParameters>
<asp:ControlParameter ControlID="CountryListBox" PropertyName="SelectedValue" />
<asp:ControlParameter ControlID="LastNameTextBox" PropertyName="Text" />
</FilterParameters>
</asp:SqlDataSource>
</form>
</body>
</html>