ASP.NET Web Forms - Элемент управления Repeater


Элемент управления Repeater используется для отображения повторяющегося списка элементов, привязанных к элементу управления.


Привязка DataSet к элементу управления Repeater

Элемент управления Repeater используется для отображения повторяющегося списка элементов, привязанных к элементу управления. Элемент управления Repeater можно привязать к таблице базы данных, XML-файлу или другому списку элементов. Здесь мы продемонстрируем, как привязать XML-файл к элементу управления Repeater.

В нашем примере мы будем использовать следующий XML-файл ("cdcatalog.xml"):

<?xml version="1.0" encoding="ISO-8859-1"?>

<catalog>
<cd>
<title>Империя бурлеска</title>
<artist>Боб Дилан</artist>
<country>США</country>
<company>Коламбия</company>
<price>10.90</price>
<year>1985</year>
</cd>
<cd>
<title>Спрячь своё сердце</title>
<artist>Бонни Тайлер</artist>
<country>Великобритания</country>
<company>CBS Records</company>
<price>9.90</price>
<year>1988</year>
</cd>
<cd>
<title>Лучшие хиты</title>
<artist>Долли Партон</artist>
<country>США</country>
<company>RCA</company>
<price>9.90</price>
<year>1982</year>
</cd>
<cd>
<title>Всё ещё блюз</title>
<artist>Гэри Мур</artist>
<country>Великобритания</country>
<company>Вирджин Рекордс</company>
<price>10.20</price>
<year>1990</year>
</cd>
<cd>
<title>Эрос</title>
<artist>Eros Ramazzotti</artist>
<country>EU</country>
<company>BMG</company>
<price>9.90</price>
<year>1997</year>
</cd>
</catalog>

Просмотреть этот XML-файл:

Сначала импортируйте пространство имен "System.Data". Это пространство имен необходимо для работы с объектом DataSet. Включите следующую директиву в верхней части страницы .aspx:

<%@ Import Namespace="System.Data" %>

Затем создайте DataSet для XML-файла и загрузите XML-файл в DataSet при первой загрузке страницы:

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
end if
end sub

Затем мы создаём элемент управления Repeater на странице .aspx. Содержимое элемента <HeaderTemplate> отображается первым и появляется в выводе только один раз, тогда как содержимое элемента <ItemTemplate> повторяется для каждой "записи" в DataSet. Наконец, содержимое элемента <FooterTemplate> появляется в выводе только один раз:

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
...
</HeaderTemplate>

<ItemTemplate>
...
</ItemTemplate>

<FooterTemplate>
...
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Затем мы добавляем скрипт, который создаёт DataSet и привязывает DataSet mycdcatalog к элементу управления Repeater. Затем мы используем HTML-теги для заполнения элемента управления Repeater и привязываем элементы данных к ячейкам внутри области <ItemTemplate> с помощью <%#Container.DataItem("fieldname")%>:

Пример

<%@ Import Namespace="System.Data" %>

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
cdcatalog.DataSource=mycdcatalog
cdcatalog.DataBind()
end if
end sub
</script>

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
<table border="1" width="100%">
<tr>
<th>Название</th>
<th>Исполнитель</th>
<th>Страна</th>
<th>Компания</th>
<th>Цена</th>
<th>Год</th>
</tr>
</HeaderTemplate>

<ItemTemplate>
<tr>
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</ItemTemplate>

<FooterTemplate>
</table>
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Посмотреть пример »

Использование <AlternatingItemTemplate>

Вы можете добавить элемент <AlternatingItemTemplate> после элемента <ItemTemplate>, чтобы описать внешний вид чередующихся строк в выводе. В приведенном ниже примере каждая вторая строка таблицы будет иметь светло-серый фон:

Пример

<%@ Import Namespace="System.Data" %>

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
cdcatalog.DataSource=mycdcatalog
cdcatalog.DataBind()
end if
end sub
</script>

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
<table border="1" width="100%">
<tr>
<th>Название</th>
<th>Исполнитель</th>
<th>Страна</th>
<th>Компания</th>
<th>Цена</th>
<th>Год</th>
</tr>
</HeaderTemplate>

<ItemTemplate>
<tr>
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</ItemTemplate>

<AlternatingItemTemplate>
<tr bgcolor="#e8e8e8">
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</AlternatingItemTemplate>

<FooterTemplate>
</table>
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Посмотреть пример »

Использование <SeparatorTemplate>

Элемент <SeparatorTemplate> используется для описания разделителя между каждой записью. В приведенном ниже примере между каждой строкой таблицы вставляется горизонтальная линия:

Пример

<%@ Import Namespace="System.Data" %>

<script runat="server">
sub Page_Load
if Not Page.IsPostBack then
dim mycdcatalog=New DataSet
mycdcatalog.ReadXml(MapPath("cdcatalog.xml"))
cdcatalog.DataSource=mycdcatalog
cdcatalog.DataBind()
end if
end sub
</script>

<html>
<body>

<form runat="server">
<asp:Repeater id="cdcatalog" runat="server">

<HeaderTemplate>
<table border="0" width="100%">
<tr>
<th>Название</th>
<th>Исполнитель</th>
<th>Страна</th>
<th>Компания</th>
<th>Цена</th>
<th>Год</th>
</tr>
</HeaderTemplate>

<ItemTemplate>
<tr>
<td><%#Container.DataItem("title")%></td>
<td><%#Container.DataItem("artist")%></td>
<td><%#Container.DataItem("country")%></td>
<td><%#Container.DataItem("company")%></td>
<td><%#Container.DataItem("price")%></td>
<td><%#Container.DataItem("year")%></td>
</tr>
</ItemTemplate>

<SeparatorTemplate>
<tr>
<td colspan="6"><hr /></td>
</tr>
</SeparatorTemplate>

<FooterTemplate>
</table>
</FooterTemplate>

</asp:Repeater>
</form>

</body>
</html>

Посмотреть пример »

Другие расширения