剖析ASP.NET2.0导航功能之控制地图信息

一、 简介

　　任何由多个页面组成的网站都需要某种导航用户接口，这是用两步来创建的。首先，必须定义站点的逻辑结构；然后，添加用户接口元素来允许用户在站点结构的各个部分之间来回移动。在ASP.NET 2.0以前，要求开发者自己来解决这两个问题。然而，到了版本2.0以后，ASP.NET提供了一个简单的方法来定义一站点的结构并且包括大量的Web控件-专门设计来显示站点导航用户接口。

　　在上一篇中我们分析了怎样通过导航Web控件来创建Web.sitemap XML站点地图文件以及怎样显示站点导航信息，这包括：

　　·SiteMapPath，它显示一个breadcrumb（Home＞Electronics＞XBOX）

　　·TreeView，它显示一个可折迭的垂直显示的树，用于显示整个站点地图层次

　　·Menu，它显示一个水平或垂直对齐的菜单

　　上一篇中只对站点地图文件和导航Web控件的功能和能力提供了一个粗略介绍。在这一部分里，我们将把注意力转到编程地控制站点地图信息，并详细地分析一下SiteMapPath导航Web控件。

　　二、 站点地图

　　本文中的示例使用在第一部分中创建的站点地图。你可以在第一部分看到该站点地图XML文件的精确的句法或在本文最后下载下来。站点结构的图形化表示使用于这些示例中，见下图：


　　三、 编程控制站点地图

　　一个站点地图是一个相关联的站点地图结点的集合。典型地，每个站点地图结点包含一标题，一个URL和一个描述。上面显示的图像是站点地图的一个示例，其中每个矩形代表一个站点地图结点。ASP.NET并不要求一特别的格式来指定站点地图，尽管它的确提供了使用一XML格式文件的默认选择。(关于XML文件的细节请参考第一篇)

　　ASP.NET提供了一个类称为SiteMap-它提供只读的，编程地存取该站点地图。这个类被两个控件内部使用，在本文的后面我们将分析这两个类：

　　·SiteMapPath-基于被访问页面和它的站点结构位置生成一个breadcrumb。具体地说，该SiteMapPath从由SiteMap.CurrentNode属性返回的结点开始，往上遍历这个层次结构直到根部。

　　·SiteMapDataSource-这个控件创建一个层次结构的数据源-它映射该站点地图的结构。为了在另外的Web控件中显示站点地图信息，例如TreeView或Menu，该Web控件并不直接查询站点地图;而是，它们绑定到一个SiteMapDataSource控件-它负责读取该站点地图结构。

　　SiteMap类有两个属性:RootNode和CurrentNode。这两个属性都返回SiteMapNode实例。SiteMapNode类代表一个定义在站点地图中的结点并且具有描述该结点的属性-Title，Url和Description，另外还有通过编程方式控制层次结构的属性-ParentNode，ChildNodes，NextSibling，PreviousSibling，等等。

　　你可以在你的自己ASP.NET页中使用SiteMap类。例如，我们能在每个页面中显示Next，Previous和Up链接-这只需通过添加三个HyperLink控件到站点的主页面，另加上一点点编程以检查是否CurrentNode有一NextSibling，PreviousSibling或ParentNode。具体地说，你将添加下列标记到你的主页面:

[＜asp:HyperLink ID="lnkPrev" runat="server"＞Prev＜/asp:HyperLink＞] | [＜asp:HyperLink ID="lnkUp" runat="server"＞Up＜/asp:HyperLink＞] | [＜asp:HyperLink ID="lnkNext" runat="server"＞Next＜/asp:HyperLink＞]

　　主页面的Page_Load事件处理器看上去如下：

If SiteMap.CurrentNode IsNot Nothing Then 　'设置next/previous/up链接 　If SiteMap.CurrentNode.PreviousSibling IsNot Nothing Then 　　lnkPrev.NavigateUrl = SiteMap.CurrentNode.PreviousSibling.Url 　　lnkPrev.Text = "< Prev (" & SiteMap.CurrentNode.PreviousSibling.Title & ")" 　Else 　　lnkPrev.NavigateUrl = String.Empty 　　lnkPrev.Text = "< Prev" 　End If 　If SiteMap.CurrentNode.ParentNode IsNot Nothing Then 　　lnkUp.NavigateUrl = SiteMap.CurrentNode.ParentNode.Url 　　lnkUp.Text = "Up (" & SiteMap.CurrentNode.ParentNode.Title & ")" 　Else 　　lnkUp.NavigateUrl = String.Empty 　　lnkUp.Text = "Up" 　End If 　If SiteMap.CurrentNode.NextSibling IsNot Nothing Then 　　lnkNext.NavigateUrl = SiteMap.CurrentNode.NextSibling.Url 　　lnkNext.Text = "(" & SiteMap.CurrentNode.NextSibling.Title & ") Next >" 　Else 　　lnkNext.NavigateUrl = String.Empty 　　lnkNext.Text = "Next >" 　End If End If

　　这将把三个超级链接Next，Up和Previous添加到从主页面继承的每一个页面，参见下图的快照。



　　需要完成这一功能的标记和代码见于本文所附源码中。

　　四、 用SiteMapPath控件显示Breadcrumbs

　　SiteMapPath控件显示一个breadcrumb-它用于向用户显示他们在该站点结构中所处的位置。SiteMapPath控件的输出由下列三个因素决定:

　　·站点的结构，由站点地图定义，

　　·被访问的页面和

　　·SiteMapPath控件的属性值

　　当访问一个有SiteMapPath控件的页面时，该SiteMapPath控件试图把页面的URL映射到定义在该站点地图中的一个站点地图结点的url值。如果找到一个匹配，该控件将上行遍历该结构到根部，并作下列输出：RootNode＞ParentNode＞...＞ParentNode＞CurrentNode。这里的CurrentNode是站点地图结点的标题-它用来映射当前页面请求的URL；RootNode和ParentNodes被作为超级链接生成，如果该站点地图结点有一个定义在该站点地图中的URL值。在"History Books"页面(Books/History.aspx)中的一个SiteMapPath控件将生成Home＞Books＞History，同时还分别生成超级链接形式的Home和Books，分别回指向Default.aspx和Books/Default.aspx。在访问Books/Default.aspx时，SiteMapPath生成Home＞Books。

　　非常清楚，SiteMapPath的输出既依赖于站点地图本身又依赖于正在被访问的页面。该SiteMapPath的输出可以被定制，通过该控件的属性。有一些标准Web控件格式的属性-BackColor，Font，ForeColor，等等-还有一些特定于SiteMapPath的设置，包括：

　　u PathDirection-可以取两个值之一它们是RootToCurrent(缺省的)或CurrentToRoot。当取值为RootToCurrent，在"History Books"页面上的breadcrumb生成为Home＞Books＞History；当取值为CurrentToRoot，输出将是History＞Books＞Home。

　　·PathSeparator-指定用于分开breadcrumb中的每个结点的字符串；缺省为＞

　　·RenderCurrentNodeAsLink-一个Boolean属性-它指定是否CurrentNode应该生成为一个链接；缺省为False。

　　·ParentLevelsDisplayed-一个整数值-它可以用于限制breadcrumb所显示树层结构的高度。缺省地，这个属性值是-1，这意味着没有限制；把它的值置为1，那么在"History Books"页面将生成breadcrumb Books＞History。根不包含在内，因为SiteMapPath控件只是向上遍历到一个父级-从"History"到"Book"。

　　·ShowToolTips-如果一站点地图结点有一个描述值，那么该描述对于每一个breadcrumb结点被显示为一个提示文本，如果这个属性被设置为True(默认情况)。

　　还有风格属性可用来设置BackColor，Font，ForeColor，等等-用于SiteMapPath控件的各个部分。可以使用NodeStyle属性来定制在breadcrumb中的结点的外观；可以使用RootNodeStyle和CurrentNodeStyle来进一步定制在breadcrumb中的第一个和最后一个结点。一般地，最简单也是最具有审美特点的来格式化该SiteMapPath控件的方法是使用它的"Auto Format"向导-这可以通过该控件的灵敏标签启动。

　　五、 用模板定制生成的输出

　　该SiteMapPath包含四个模板-它们允许进一步定制生成的输出。模板允许混合使用静态HTML标记，Web控件和数据绑定语法；如果你以前已使用了DataList或Repeater控件，那么你已对模板很熟悉了。在ASP.NET 2.0中的模板基本上同ASP.NET 1.x中的一样，除了ASP.NET 2.0引入了一些新的更精练的语法来数据绑定表达式外。例如，在ASP.NET 1.x中，你必须使用语法＜%# DataBinder.Eval(Container.DataItem, PropertyName) %＞来取得一列的值。而在ASP.NET 2.0中，这种老式的语法仍可以使用，但是你可以选择性地使用更短的版本＜%# Eval(PropertyName) %＞。

　　默认地，SiteMapPath以常规超级链接方式生成根和父结点，这样当用户点击该链接时，他们可以在该控件层次树上快速地向上回退。然而，在把信息发送回用户前，你可能想做一些服务器端处理-也许你想要记录下用户要到哪里去或自动地保存他们在该页面所做的任何变化。可以通过使用一个模板和把该结点生成为一个LinkButton来实现这一功能。

　　例如，如果你只想要把SiteMapPath的根结点生成为一个LinkButton，你可以用下面的标记来把一个＜RootNodeTemplate＞添加到SiteMapPath控件上：

＜asp:SiteMapPath ID="SiteMapPath1" runat="server"＞ ＜RootNodeTemplate＞ ＜asp:LinkButton ID="LinkButton1" runat="server" Text='＜%# Eval("title") %＞' CommandArgument='＜%# Eval("url") %＞' OnCommand="LinkButton1_Command"＞ ＜/asp:LinkButton＞ ＜/RootNodeTemplate＞ ＜/asp:SiteMapPath＞

　　这个标记添加一LinkButton控件到SiteMapPath-它的Text属性被分配给相应SiteMapNode的Title属性。当点击该LinkButton时，将导致一个回寄并且该控件的Command事件激发-这将激活LinkButton1_Command事件处理器。SiteMapNode的Url属性被通过CommandArgument属性传递到这个事件处理器。在这个事件处理器中，你可以做任何服务器端所需要的处理，然后通过Response.Redirect(e.CommandArgument)把用户引导到他们所请求的页面上去。

查看本文来源