ASP.NET - Controle DataList

O controle DataList, semelhante ao controle Repeater, é usado para exibir listas repetitivas de itens limitadas ao controle. No entanto, o controle DataList adiciona automaticamente uma tabela aos itens de dados.

Vincular DataSet ao controle DataList

O controle DataList, semelhante ao controle Repeater, é usado para exibir listas repetitivas de itens limitadas ao controle. No entanto, o controle DataList adiciona automaticamente uma tabela aos itens de dados. O controle DataList pode ser vinculado a tabelas de banco de dados, arquivos XML ou outras listas de itens. Aqui, vamos mostrar como vincular um arquivo XML a um controle DataList.

Vamos usar o seguinte arquivo XML ("cdcatalog.xml") no exemplo:

<?xml version="1.0" encoding="ISO-8859-1"?>
<catalog>
<cd>
  <title>Empire Burlesque</title>
  <artist>Bob Dylan</artist>
  <country>USA</country>
  <company>Columbia</company>
  <price>10.90</price>
  <year>1985</year>
</cd>
<cd>
  <title>Hide your heart</title>
  <artist>Bonnie Tyler</artist>
  <country>UK</country>
  <company>CBS Records</company>
  <price>9.90</price>
  <year>1988</year>
</cd>
<cd>
  <title>Greatest Hits</title>
  <artist>Dolly Parton</artist>
  <country>USA</country>
  <company>RCA</company>
  <price>9.90</price>
  <year>1982</year>
</cd>
<cd>
  <title>Still got the blues</title>
  <artist>Gary Moore</artist>
  <country>UK</country>
  <company>Virgin records</company>
  <price>10.20</price>
  <year>1990</year>
</cd>
<cd>
  <title>Eros</title>
  <artist>Eros Ramazzotti</artist>
  <country>EU</country>
  <company>BMG</company>
  <price>9.90</price>
  <year>1997</year>
</cd>
</catalog>

Por favor, verifique esse arquivo XML:cdcatalog.xml

Primeiro, importe o espaço de nomes "System.Data" . Necessitamos desse espaço de nomes para trabalhar com o objeto DataSet. Inclua a seguinte instrução no cabeçalho da página .aspx:

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

A seguir, crie um DataSet para esse arquivo XML e carregue esse arquivo XML no DataSet no carregamento inicial da página:

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

Então, criamos um controle DataList na página .aspx. O conteúdo do elemento <HeaderTemplate> aparece apenas uma vez na saída, enquanto o conteúdo do elemento <ItemTemplate> coincide com a repetição do "record" no DataSet. Por fim, o conteúdo do <FooterTemplate> aparece apenas uma vez na saída:

<html>
<body>
<form runat="server">
<asp:DataList id="cdcatalog" runat="server">
<HeaderTemplate>
...
</HeaderTemplate>
<ItemTemplate>
...
</ItemTemplate>
<FooterTemplate>
...
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>

Em seguida, adicionamos o script que cria o DataSet e vinculamos o DataSet mycdcatalog ao controle DataList. Também usamos esses elementos para preencher o controle DataList: <HeaderTemplate> que contém o cabeçalho, <ItemTemplate> que contém os itens a serem exibidos e <FooterTemplate> que contém o texto. Observe que o atributo gridlines do DataList está configurado como "both" para exibir as bordas da tabela:

<%@ 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:DataList id="cdcatalog">
gridlines="both" runat="server">
<HeaderTemplate>
Meu Catálogo de CDs
</HeaderTemplate>
<ItemTemplate>
"<%#Container.DataItem("title")%>" de
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>
<FooterTemplate>
Copyright codew3c.com
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>

Exibir este exemplo

Usando estilos

Você também pode adicionar estilos ao controle DataList para torná-lo mais elegante:

<%@ 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:DataList id="cdcatalog">
runat="server"
cellpadding="2"
cellspacing="2"
borderstyle="inset"
backcolor="#e8e8e8"
width="100%"
headerstyle-font-name="Verdana"
headerstyle-font-size="12pt"
headerstyle-horizontalalign="center"
headerstyle-font-bold="true"
itemstyle-backcolor="#778899"
itemstyle-forecolor="#ffffff"
footerstyle-font-size="9pt"
footerstyle-font-italic="true"
<HeaderTemplate>
Meu Catálogo de CDs
</HeaderTemplate>
<ItemTemplate>
"<%#Container.DataItem("title")%>" de
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>
<FooterTemplate>
Copyright codew3c.com
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>

Exibir este exemplo

Usando <AlternatingItemTemplate>

Você pode adicionar o elemento <AlternatingItemTemplate> após o <ItemTemplate> para descrever o estilo das linhas alternadas. Você pode aplicar estilos ao parte <AlternatingItemTemplate> dentro do controle DataList:

<%@ 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:DataList id="cdcatalog">
runat="server"
cellpadding="2"
cellspacing="2"
borderstyle="inset"
backcolor="#e8e8e8"
width="100%"
headerstyle-font-name="Verdana"
headerstyle-font-size="12pt"
headerstyle-horizontalalign="center"
headerstyle-font-bold="True"
itemstyle-backcolor="#778899"
itemstyle-forecolor="#ffffff"
alternatingitemstyle-backcolor="#e8e8e8"
alternatingitemstyle-forecolor="#000000"
footerstyle-font-size="9pt"
footerstyle-font-italic="True">
<HeaderTemplate>
Meu Catálogo de CDs
</HeaderTemplate>
<ItemTemplate>
"<%#Container.DataItem("title")%>" de
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</ItemTemplate>
<AlternatingItemTemplate>
"<%#Container.DataItem("title")%>" de
<%#Container.DataItem("artist")%> -
$<%#Container.DataItem("price")%>
</AlternatingItemTemplate>
<FooterTemplate>
© codew3c.com
</FooterTemplate>
</asp:DataList>
</form>
</body>
</html>

Exibir este exemplo