SiteMapPath Web 服务器控件概述

更新:2007 年 11 月

SiteMapPath 会显示一个导航路径(也称为面包屑或眉毛导航),此路径为用户显示当前页的位置,并显示返回到主页的路径链接。

本主题包括:

  • 背景

  • 代码示例

  • 类参考

背景

SiteMapPath 控件包含来自站点地图的导航数据。此数据包括有关网站中的页的信息,如 URL、标题、说明和导航层次结构中的位置。若将导航数据存储在一个地方,则可以更方便地在网站的导航菜单中添加和删除项。

下面的代码示例演示包含在 Web.sitemap 文件中的站点地图数据。

<siteMap>
  <siteMapNode title="Home" description="Home" url="~/default.aspx" >
    <siteMapNode title="Services" description="Services we offer" 
      url="~/Services.aspx">
    <siteMapNode title="Training" description="Training classes" 
      url="~/Training.aspx" />
    <siteMapNode title="Consulting" description="Consulting services" 
      url="~/Consulting.aspx" />
    </siteMapNode>
  </siteMapNode>
</siteMap>
x20z8c51.alert_note(zh-cn,VS.90).gif说明:

只有在站点地图中列出的页才能在 SiteMapPath 控件中显示导航数据。如果将 SiteMapPath 控件放置在站点地图中未列出的页上,该控件将不会向客户端显示任何信息。

通过添加下面的代码,可以向 Training.aspx 页添加 SiteMapPath 控件。

<asp:SiteMapPath ID="SiteMapPath1" Runat="server"></asp:SiteMapPath>

当在浏览器中查看 Training.aspx 页时,SiteMapPath 控件将显示如下类似信息,并以超链接的形式呈现“主页”和“服务”:

        主页 > 服务 > 培训

使用 SiteMapPath 控件无需代码和绑定数据就能创建站点导航。此控件可自动读取和呈现站点地图信息。但如果需要,您也可以使用 SiteMapPath 控件来更改站点地图数据。有关更多信息,请参见如何:以编程方式修改内存中的站点地图节点

SiteMapPath 控件使用户能够向后导航 -- 从当前页到站点层次结构中更高层的页。但是,SiteMapPath 控件不让用户向前导航 -- 从当前页到站点层次结构中较低层的页。例如,可以在新闻组或者留言板应用程序中使用 SiteMapPath 控件,使用户能查看当前浏览的文章的路径。

代码示例

如何:添加简单的站点导航

如何:自定义 SiteMapPath Web 服务器控件的外观

如何:配置多个站点地图和站点地图提供程序

返回页首

类参考

下表列出了与 SiteMapPath 控件相关的类。

成员

说明

SiteMapPath

控件的主类。

返回页首

请参见

任务

如何:自定义 SiteMapPath Web 服务器控件的外观

如何:筛选 SiteMapDataSource Web 服务器控件检索到的节点

概念

ASP.NET 站点导航概述

保证 ASP.NET 站点导航的安全

保证数据访问的安全

参考

SiteMapPath

XmlSiteMapProvider

其他资源

寄宿环境中的 ASP.NET 应用程序安全性