属性

虽然，SiteMapPath服务器控件可以简单地实现页面导航功能，但是，默认情况下，它生成的最终结果还是比较简单的。该控件的一些属性可以帮助程序开发人员定义显示的样式，从而适应站点的总体设计风格。

SiteMapPath控件的常用属性及说明如表1所示。



表1 SiteMapPath控件的常用属性及说明

下面对比较重要的属性进行详细介绍。

（1）ParentLevelsDisplayed属性。

ParentLevelsDisplayed属性用于获取或设置SiteMapPath控件显示相对于当前显示节点的父节点级别数。例如，将ParentLevelsDisplayed属性设置为3，则表示在当前节点之前，还要显示3级父节点。

语法：

[ThemeableAttribute(False)]

public virtual int ParentLevelsDisplayed { get; set; }

属性值：指定相对于当前节点显示的父节点的级别数。默认值为−1，表示将所有节点完全展开。

（2）PathDirection属性。

PathDirection用来获取或设置节点显示的方向。有两种显示方向可供选择：CurrentToRoot和RootToCurrent。默认值为RootToCurrent。例如，当设置PathDirection属性值为RootToCurrent时，显示方式为从最顶部的节点到当前节点（例如，主页>明日科技图书>C#技术大全），当设置PathDirection值为CurrentToRoot时，显示方式为从当前节点到最顶部节点（例如，C#技术大全>明日科技图书>主页）。

语法：

public virtual PathDirection PathDirection { get; set; }

属性值：PathDirection表示导航节点显示的分层顺序。默认值为RootToCurrent，表示节点显示的方式为从最顶部的节点到当前节点。

（3）SiteMapProvider属性。

SiteMapProvider属性是服务器控件SiteMapPath用来获取站点地图数据的数据源。如果未设置SiteMapProvider属性，SiteMapPath控件会使用SiteMap类的Provider属性获取当前站点地图的默认SiteMapProvider对象。其中SiteMap类是站点导航结构在内存中的表示形式，导航结构由一个或多个站点地图组成。

语法：

[ThemeableAttribute(False)]

public virtual string SiteMapProvider { get; set; }

属性值：SiteMapProvider定义了要显示导航控件SiteMapPath的导航结构。