Sintaxis declarativa del control de servidor Web SiteMapDataSource
Actualización: noviembre 2007
Proporciona un control de origen de datos que los controles de servidor Web y otros controles pueden utilizar para enlazar con datos jerárquicos del mapa de sitios.
<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"
/>
Comentarios
El control SiteMapDataSource es un origen de datos para los datos del mapa de sitios que almacenan los proveedores del mapa de sitios que están configurados para su sitio. El control SiteMapDataSource habilita a los controles de servidor Web que no son controles de navegación del sitio específicamente, como por ejemplo los controles TreeView, Menu y DropDownList, para enlazar con datos jerárquicos del mapa de sitios. Estos controles de servidor Web se pueden utilizar para mostrar un mapa de sitios como una tabla de contenido o para navegar de forma activa un sitio. Como alternativa, puede utilizar el control SiteMapPath que está diseñado especialmente como control de navegación de un sitio y por tanto no necesita una instancia del control SiteMapDataSource.
Para obtener más información sobre el control SiteMapDataSource y sobre controles de navegación, vea Controles de exploración del Cuadro de herramientas.
Ejemplo
El siguiente ejemplo de código muestra cómo enlazar mediante declaración un control TreeView con un mapa de sitios utilizando un control SiteMapDataSource. Los datos del mapa de sitios se obtienen comenzando en el nivel de nodo raíz.
<%@ 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>