Sintassi dichiarativa per il controllo server Web SiteMapDataSource
Aggiornamento: novembre 2007
Fornisce un controllo origine dati che può essere utilizzato dai controlli server Web e da altri controlli per l'associazione a dati della mappa del sito gerarchica.
<asp:SiteMapDataSource
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
ShowStartingNode="True|False"
SiteMapProvider="string"
SkinID="string"
StartFromCurrentNode="True|False"
StartingNodeOffset="integer"
StartingNodeUrl="uri"
Visible="True|False"
/>
Note
Il controllo SiteMapDataSource è un'origine dati della mappa del sito memorizzata dai provider della mappa configurati per il sito. Il controllo SiteMapDataSource consente di associare controlli server Web che non sono in modo specifico controlli di spostamento nel sito, ad esempio TreeView, Menu e DropDownList, ai dati della mappa del sito gerarchica. Questi controlli server Web possono essere utilizzati per visualizzare una mappa del sito come sommario o per spostarsi attivamente in un sito. In alternativa è possibile utilizzare il controllo SiteMapPath, che è stato progettato specificamente come controllo di spostamento nei siti e pertanto non richiede un'istanza del controllo SiteMapDataSource.
Per ulteriori informazioni sull'utilizzo del controllo SiteMapDataSource e dei controlli di spostamento, vedere Controlli della Casella degli strumenti di esplorazione.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come associare in modo dichiarativo un controllo TreeView a una mappa di sito mediante un controllo SiteMapDataSource. I dati della mappa del sito vengono recuperati a partire dal livello del nodo principale.
<%@ 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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SiteMapDataSource
id="SiteMapDataSource1"
runat="server" />
<asp:TreeView
id="TreeView1"
runat="server"
DataSourceID="SiteMapDataSource1">
</asp:TreeView>
</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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SiteMapDataSource
id="SiteMapDataSource1"
runat="server" />
<asp:TreeView
id="TreeView1"
runat="server"
DataSourceID="SiteMapDataSource1">
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VJ#" %>
<!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">
<asp:SiteMapDataSource
id="SiteMapDataSource1"
runat="server">
</asp:SiteMapDataSource>
<asp:TreeView
id="TreeView1"
runat="server"
DataSourceID="SiteMapDataSource1">
</asp:TreeView>
</form>
</body>
</html>