Associazione a dati gerarchici
Aggiornamento: novembre 2007
I controlli origine dati possono essere utilizzati con dati tabulari (dati basati su tabella o relazionali), dati gerarchici o entrambi. I controlli SqlDataSource e ObjectDataSource sono esempi di controlli origine dati che vengono utilizzati con i dati tabulari. In ASP.NET sono disponibili anche due controlli origine dati che semplificano l'associazione ai dati gerarchici: il controllo XmlDataSource, che viene utilizzato con i dati XML di un file o una stringa, e il controllo SiteMapDataSource, che viene utilizzato con i dati sul sistema di spostamento all'interno dei siti (gestiti, per impostazione predefinita, come dati XML). I controlli origine dati gerarchici vengono utilizzati negli scenari di sola lettura per la visualizzazione dei dati.
In questo argomento vengono fornite ulteriori informazioni sull'associazione dei controlli con associazione a dati a un'origine dati gerarchici. Per ulteriori informazioni sui controlli XmlDataSource e SiteMapDataSource, vedere Cenni preliminari sul controllo server Web XmlDataSource e Cenni preliminari sul controllo server Web SiteMapDataSource.
Associazione di un controllo gerarchico ai dati XML
I dati XML hanno una struttura intrinsecamente gerarchica e possono essere visualizzati nelle pagine Web ASP.NET mediante i controlli con associazione a dati gerarchici, ad esempio il controllo TreeView o il controllo Menu. È possibile eseguire l'associazione a un controllo origine dati gerarchici mediante l'impostazione della proprietà DataSourceID del controllo gerarchico sull'ID di un controllo XmlDataSource o SiteMapDataSource.
Nell'esempio di codice riportato di seguito viene illustrato un controllo TreeView associato a un controllo XmlDataSource. I dati XML vengono filtrati mediante una query XPath.
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script >
Sub SelectRegion(sender As Object, e As EventArgs)
If RegionDropDownList.SelectedValue = "(Show All)" Then
PeopleDataSource.XPath = "/People/Person"
Else
Dim selectedValue As String = ""
Select Case RegionDropDownList.SelectedValue
Case "CA"
selectedValue = "CA"
Case "HI"
selectedValue = "HI"
Case "WA"
selectedValue = "WA"
Case Else
' Invalid value.
End Select
PeopleDataSource.XPath = "/People/Person[Address/Region='" & selectedValue & "']"
End If
PeopleTreeView.DataBind()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head >
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" >
<table border="0" cellpadding="3">
<tr>
<td valign="top">
<b>Select Region:</b>
<asp:DropDownList id="RegionDropDownList" AutoPostBack="True"
OnSelectedIndexChanged="SelectRegion">
<asp:ListItem Selected="True">(Show All)</asp:ListItem>
<asp:ListItem>CA</asp:ListItem>
<asp:ListItem>HI</asp:ListItem>
<asp:ListItem>WA</asp:ListItem>
</asp:DropDownList>
</td>
<td valign="top">
<asp:XmlDataSource
id="PeopleDataSource"
XPath="/People/Person"
DataFile="~/App_Data/people.xml" />
<asp:TreeView
id="PeopleTreeView"
DataSourceID="PeopleDataSource">
<DataBindings>
<asp:TreeNodeBinding DataMember="LastName" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="FirstName" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Street" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="City" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Region" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="ZipCode" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Title" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Description" TextField="#InnerText" />
</DataBindings>
</asp:TreeView>
</td>
</tr>
</table>
</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">
<script >
void SelectRegion(object sender, EventArgs e)
{
if (RegionDropDownList.SelectedValue == "(Show All)")
PeopleDataSource.XPath = "/People/Person";
else
{
string selectedValue = "";
switch (RegionDropDownList.SelectedValue)
{
case "CA":
selectedValue = "CA";
break;
case "HI":
selectedValue = "HI";
break;
case "WA":
selectedValue = "WA";
break;
default:
// Invalid value.
break;
}
PeopleDataSource.XPath = "/People/Person[Address/Region='" + selectedValue + "']";
}
PeopleTreeView.DataBind();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head >
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" >
<table border="0" cellpadding="3">
<tr>
<td valign="top">
<b>Select Region:</b>
<asp:DropDownList id="RegionDropDownList" AutoPostBack="True"
OnSelectedIndexChanged="SelectRegion">
<asp:ListItem Selected="True">(Show All)</asp:ListItem>
<asp:ListItem>CA</asp:ListItem>
<asp:ListItem>HI</asp:ListItem>
<asp:ListItem>WA</asp:ListItem>
</asp:DropDownList>
</td>
<td valign="top">
<asp:XmlDataSource
id="PeopleDataSource"
XPath="/People/Person"
DataFile="~/App_Data/people.xml" />
<asp:TreeView
id="PeopleTreeView"
DataSourceID="PeopleDataSource">
<DataBindings>
<asp:TreeNodeBinding DataMember="LastName" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="FirstName" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Street" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="City" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Region" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="ZipCode" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Title" TextField="#InnerText" />
<asp:TreeNodeBinding DataMember="Description" TextField="#InnerText" />
</DataBindings>
</asp:TreeView>
</td>
</tr>
</table>
</form>
</body>
</html>
Associazione di un controllo tabulare ai dati XML
Il controllo XmlDataSource viene utilizzato principalmente per esporre i dati XML ai controlli con associazione a dati gerarchici, ad esempio i controlli TreeView e Menu. È tuttavia possibile associare controlli con associazione a dati tabulari, ad esempio il controllo GridView o DataList, al controllo XmlDataSource.
Quando si associa un controllo con associazione a dati tabulari al controllo XmlDataSource, il controllo con associazione a dati restituisce solo il primo livello della gerarchia XML. In un modello di controllo con associazione a dati, tuttavia, è possibile utilizzare anche i metodi di associazione dati XPath e XPathSelect per eseguire l'associazione a elementi specifici all'interno della gerarchia XML. Il metodo di associazione dati XPath restituisce un valore da un nodo o un attributo in un punto qualsiasi della gerarchia. Il metodo XPathSelect restituisce un elenco di nodi che corrispondono a un'espressione XPath. Il controllo di dati tabulari può utilizzare tali nodi come se fossero un insieme di record di dati.
Per ulteriori informazioni ed esempi, vedere Associazione di un controllo tabulare al controllo XmlDataSource.
Altri tipi di dati gerarchici
Oltre all'associazione di controlli a un controllo XmlDataSource, illustrata nel presente argomento, è possibile eseguire anche l'associazione di un controllo gerarchico a un file sitemap. Per ulteriori informazioni, vedere Mappe del sito ASP.NET. Nel codice di esempio riportato di seguito viene illustrato come associare un controllo Menu a un controllo SiteMapDataSource.
<%@ 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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head >
<title>Menu DataBinding Example</title>
</head>
<body>
<form id="form1" >
<h3>Menu DataBinding Example</h3>
<!-- Bind the Menu control to a SiteMapDataSource control. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
datasourceid="MenuSource"
>
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
/>
</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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head >
<title>Menu DataBinding Example</title>
</head>
<body>
<form id="form1" >
<h3>Menu DataBinding Example</h3>
<!-- Bind the Menu control to a SiteMapDataSource control. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
datasourceid="MenuSource"
>
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
/>
</form>
</body>
</html>
Per creare i dati per l'esempio, è possibile copiare i dati della mappa del sito di esempio in un file nell'applicazione Web denominata Web.sitemap.
<siteMap>
<siteMapNode url="~\Home.aspx"
title="Home"
description="Home">
<siteMapNode url="~\Music.aspx"
title="Music"
description="Music">
<siteMapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<siteMapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<siteMapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</siteMapNode>
<siteMapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<siteMapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<siteMapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<siteMapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</siteMapNode>
</siteMapNode>
</siteMap>
Vedere anche
Concetti
Cenni preliminari sul controllo server Web XmlDataSource
Associazione di un controllo tabulare al controllo XmlDataSource
Cenni preliminari sul controllo server Web SiteMapDataSource
Cenni preliminari sul controllo Menu