<siteMapNode
 title="Customizing the Site Map" url="~/SiteMapProvider/Default.aspx"
 description="Learn how to create a custom provider that retrieves the site map from the Northwind database." />

<asp:GridView ID="Categories" runat="server" AutoGenerateColumns="False"
 DataKeyNames="CategoryID" DataSourceID="CategoriesDataSource"
 EnableViewState="False">
 <Columns>
 <asp:HyperLinkField DataNavigateUrlFields="CategoryID"
  DataNavigateUrlFormatString=
  "~/SiteMapProvider/ProductsByCategory.aspx"
  Text="View Products" />
 <asp:BoundField DataField="CategoryName" HeaderText="Category"
  SortExpression="CategoryName" />
 <asp:BoundField DataField="Description" HeaderText="Description"
  SortExpression="Description" />
 </Columns>
</asp:GridView>

<asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}" SelectMethod="GetCategories"
 TypeName="CategoriesBLL"></asp:ObjectDataSource>

<asp:GridView ID="ProductsByCategory" runat="server" AutoGenerateColumns="False"
 DataKeyNames="ProductID" DataSourceID="ProductsByCategoryDataSource"
 EnableViewState="False">
 <Columns>
 <asp:HyperLinkField DataNavigateUrlFields="ProductID"
  DataNavigateUrlFormatString=
  "~/SiteMapProvider/ProductDetails.aspx"
  Text="View Details" />
 <asp:BoundField DataField="ProductName" HeaderText="Product"
  SortExpression="ProductName" />
 <asp:BoundField DataField="UnitPrice" DataFormatString="{0:c}"
  HeaderText="Price" HtmlEncode="False"
  SortExpression="UnitPrice" />
 <asp:BoundField DataField="SupplierName" HeaderText="Supplier"
  ReadOnly="True" SortExpression="SupplierName" />
 </Columns>
</asp:GridView>

<asp:ObjectDataSource ID="ProductsByCategoryDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}"
 SelectMethod="GetProductsByCategoryID" TypeName="ProductsBLL">
 <SelectParameters>
 <asp:QueryStringParameter Name="categoryID"
  QueryStringField="CategoryID" Type="Int32" />
 </SelectParameters>
</asp:ObjectDataSource>

<asp:DetailsView ID="ProductInfo" runat="server" AutoGenerateRows="False"
 DataKeyNames="ProductID" DataSourceID="ProductDataSource"
 EnableViewState="False">
 <Fields>
 <asp:BoundField DataField="ProductName" HeaderText="Product"
  SortExpression="ProductName" />
 <asp:BoundField DataField="CategoryName" HeaderText="Category"
  ReadOnly="True" SortExpression="CategoryName" />
 <asp:BoundField DataField="SupplierName" HeaderText="Supplier"
  ReadOnly="True" SortExpression="SupplierName" />
 <asp:BoundField DataField="QuantityPerUnit" HeaderText="Qty/Unit"
  SortExpression="QuantityPerUnit" />
 <asp:BoundField DataField="UnitPrice" DataFormatString="{0:c}"
  HeaderText="Price" HtmlEncode="False"
  SortExpression="UnitPrice" />
 <asp:BoundField DataField="UnitsInStock" HeaderText="Units In Stock"
  SortExpression="UnitsInStock" />
 <asp:BoundField DataField="UnitsOnOrder" HeaderText="Units On Order"
  SortExpression="UnitsOnOrder" />
 <asp:BoundField DataField="ReorderLevel" HeaderText="Reorder Level"
  SortExpression="ReorderLevel" />
 <asp:CheckBoxField DataField="Discontinued" HeaderText="Discontinued"
  SortExpression="Discontinued" />
 </Fields>
</asp:DetailsView>

<asp:ObjectDataSource ID="ProductDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}"
 SelectMethod="GetProductByProductID" TypeName="ProductsBLL">
 <SelectParameters>
 <asp:QueryStringParameter Name="productID"
  QueryStringField="ProductID" Type="Int32" />
 </SelectParameters>
</asp:ObjectDataSource>

<configuration>
 <system.web>
 ...

 <siteMap defaultProvider="defaultProviderName">
  <providers>
  <add name="name" type="type" />
  </providers>
 </siteMap>
 </system.web>
</configuration>

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.Web.Caching;

public class NorthwindSiteMapProvider : StaticSiteMapProvider
{
 private readonly object siteMapLock = new object();
 private SiteMapNode root = null;
 public const string CacheDependencyKey =
 "NorthwindSiteMapProviderCacheDependency";

 public override SiteMapNode BuildSiteMap()
 {
 // Use a lock to make this method thread-safe
 lock (siteMapLock)
 {
  // First, see if we already have constructed the
  // rootNode. If so, return it...
  if (root != null)
  return root;

  // We need to build the site map!
  
  // Clear out the current site map structure
  base.Clear();

  // Get the categories and products information from the database
  ProductsBLL productsAPI = new ProductsBLL();
  Northwind.ProductsDataTable products = productsAPI.GetProducts();

  // Create the root SiteMapNode
  root = new SiteMapNode(
  this, "root", "~/SiteMapProvider/Default.aspx", "All Categories");
  AddNode(root);

  // Create SiteMapNodes for the categories and products
  foreach (Northwind.ProductsRow product in products)
  {
  // Add a new category SiteMapNode, if needed
  string categoryKey, categoryName;
  bool createUrlForCategoryNode = true;
  if (product.IsCategoryIDNull())
  {
   categoryKey = "Category:None";
   categoryName = "None";
   createUrlForCategoryNode = false;
  }
  else
  {
   categoryKey = string.Concat("Category:", product.CategoryID);
   categoryName = product.CategoryName;
  }

  SiteMapNode categoryNode = FindSiteMapNodeFromKey(categoryKey);

  // Add the category SiteMapNode if it does not exist
  if (categoryNode == null)
  {
   string productsByCategoryUrl = string.Empty;
   if (createUrlForCategoryNode)
   productsByCategoryUrl =
    "~/SiteMapProvider/ProductsByCategory.aspx"
    + product.CategoryID;

   categoryNode = new SiteMapNode(
   this, categoryKey, productsByCategoryUrl, categoryName);
   AddNode(categoryNode, root);
  }

  // Add the product SiteMapNode
  string productUrl =
   "~/SiteMapProvider/ProductDetails.aspx"
   + product.ProductID;
  SiteMapNode productNode = new SiteMapNode(
   this, string.Concat("Product:", product.ProductID),
   productUrl, product.ProductName);
  AddNode(productNode, categoryNode);
  }
  
  // Add a "dummy" item to the cache using a SqlCacheDependency
  // on the Products and Categories tables
  System.Web.Caching.SqlCacheDependency productsTableDependency =
  new System.Web.Caching.SqlCacheDependency("NorthwindDB", "Products");
  System.Web.Caching.SqlCacheDependency categoriesTableDependency =
  new System.Web.Caching.SqlCacheDependency("NorthwindDB", "Categories");

  // Create an AggregateCacheDependency
  System.Web.Caching.AggregateCacheDependency aggregateDependencies =
  new System.Web.Caching.AggregateCacheDependency();
  aggregateDependencies.Add(productsTableDependency, categoriesTableDependency);

  // Add the item to the cache specifying a callback function
  HttpRuntime.Cache.Insert(
  CacheDependencyKey, DateTime.Now, aggregateDependencies,
  Cache.NoAbsoluteExpiration, Cache.NoSlidingExpiration,
  CacheItemPriority.Normal,
  new CacheItemRemovedCallback(OnSiteMapChanged));


  // Finally, return the root node
  return root;
 }
 }

 protected override SiteMapNode GetRootNodeCore()
 {
 return BuildSiteMap();
 }

 protected void OnSiteMapChanged(string key, object value, CacheItemRemovedReason reason)
 {
 lock (siteMapLock)
 {
  if (string.Compare(key, CacheDependencyKey) == 0)
  {
  // Refresh the site map
  root = null;
  }
 }
 }

 public DateTime"color: #ff0000">注意：对那种CategoryID为NULL值的产品，统统将其归为一个category，其对应的category SiteMapNode的Title属性可设置为“None”；Url属性设置为空字符串。我将其Url设置为空字符串是因为ProductBLL class类的GetProductsByCategory(categoryID)方法无法返回那些CategoryID值为NULL的产品.不过我鼓励你对本教程进行扩展，使该category SiteMapNode的Url属性对应一个ProductsByCategory.aspx页面，该页面专门用来展示那些CategoryID为NULL的产品.

　　当完成site map的构建后，将一个AggregateCacheDependency object对象添加到data cache，该对象使用基于Categories 和 Products表的SQL cache dependency技术。我们在前面的教程里探讨过SQL cache dependencies，不过我们自定义的site map provider使用的是重载(overload)的data cache的Insert方法，该重载方法接受一个delegate作为输入参数.具体而言，我们将传入一个CacheItemRemovedCallback delegate，其指向OnSiteMapChanged method方法，该方法定义在NorthwindSiteMapProvider class类里

注意：内存里的site map表述是缓存在一个“类级”(class-level)变量root里的.由于只有一个site map provider的实例(instance)，并且对web应用程序的线程来说都是共享的，这个类级变量当作缓存服务。BuildSiteMap method方法也会用到data cache，但仅仅做作为一种探测Categories 或 Products表里的数据发生改变的方法。注意添加到data cache里的仅仅是当前的date和time，实际的site map数据并没有添加到data cache.
BuildSiteMap method方法最后返回网站地图的根节点.
　　剩下的方法就比较简单易懂了.GetRootNodeCore方法用来返回根节点，由于BuildSiteMap返回根节点root， GetRootNodeCore方法仅仅返回BuildSiteMap方法的返回值.当缓存条码被清除掉时，OnSiteMapChanged方法将root设置为null；当root为null的时候，当下一次调用BuildSiteMap时，将重新创建地图网站结构.最后，如果data cache里存储有date 和 time值的话，CachedDate属性将返回这些值.页面开发员可以用该属性来探测site map数据最近被缓存的时间.
第七步：对NorthwindSiteMapProvider进行登记
　　为了使用我们在第六步创建的NorthwindSiteMapProvider site map provider，我们需要在Web.config文件的<siteMap>部分进行注册.具体来说，将下面的代码添加到Web.config文件的<system.web>部分：


<siteMap defaultProvider="AspNetXmlSiteMapProvider">
 <providers>
 <add name="Northwind" type="NorthwindSiteMapProvider" />
 </providers>
</siteMap>


　　上述代码阐明了如下2个事实：第一，它指明了“内置”的AspNetXmlSiteMapProvider为默认的site map provider；第二，它将我们在第六步创建的用户自定义site map provider进行了注册，取名为“Northwind”.

注意：对那些位于在App_Code文件夹的site map providers而言，type属性的值就是类的名称.还一种方法，我们可以用一个单独的类库工程来创建自定义的site map provider，将其编译文件放置在/Bin目录；如果是那样的话，type属性就变成了“Namespace.ClassName, AssemblyName”.
　　更新Web.config文件后，花点时间在浏览器里登录本教程的任何一个页面，我们注意到左边的导航界面跟以前一样，那是因为我们把AspNetXmlSiteMapProvider作为默认的provider，为了使导航用户界面使用我们定制的NorthwindSiteMapProvider，我们应明确的指定使用“Northwind” site map provider，我们将在第八步完成.
第八步：使用定制的Site Map Provider来显示网站地图信息
　　把我们定制的site map provider注册到Web.config文件后，我们可以将导航控件添加到SiteMapProvider文件夹里的Default.aspx, ProductsByCategory.aspx, 和ProductDetails.aspx页面.首先，打开Default.aspx页面进入设计模式，从工具箱拖一个SiteMapPath控件到页面。该控件位于工具箱的导航区域.


图16：为Default.aspx页面添加一个SiteMapPath控件
　　SiteMapPath控件包含一个breadcrumb，用来显示当前页面在网站地图里的位置。我们在第三章《模板页和站点导航》里在模板页的顶部添加了一个SiteMapPath控件.
　　花点时间在浏览器里登录页面，我们在图16里添加的SiteMapPath控件使用的是默认的site map provider，它从Web.sitemap文件获取数据，因此breadcrumb显示为“Home > Customizing the Site Map”.如下图：


图17：Breadcrumb使用的是默认的Site Map Provider
　　要使在图16里添加的SiteMapPath使用我们定制的site map provider的话，设其SiteMapProvider property属性为“Northwind”, 这个名字是我们在Web.config文件里分配给NorthwindSiteMapProvider的.不过，在设计器里依然使用的是默认的site map provider，但是如你在浏览器里登录该页面的话，你将看到breadcrumb使用的是我们定制的site map provider了.


图18：Breadcrumb现在使用的是我们定制的NorthwindSiteMapProvider
　　SiteMapPath控件将在ProductsByCategory.aspx 和 ProductDetails.aspx页面展示更具功能性的用户界面.在这2个页面里添加SiteMapPath控件，设置其SiteMapProvider属性为“Northwind”. 在Default.aspx页面里点击Beverages类的“View Products”链接，然后再点Chai Tea的“View Details”链接，如图19所示，breadcrumb显示的是当前的网站地图节点(“Chai Tea”)，及其上级节点：“Beverages” 和“All Categories”.


图19：Breadcrumb现在使用的是我们定制的NorthwindSiteMapProvider
　　除了SiteMapPath外，还可以使用其它的导航控件，比如Menu 和 TreeView控件.本章的下载代码里，Default.aspx, ProductsByCategory.aspx,和ProductDetails.aspx页面都包含Menu控件(见图20).要想更深入的了解ASP.NET 2.0里的导航控件和site map体系的话，可参阅《ASP.NET 2.0 QuickStarts》系列（http://quickstarts.asp.net/QuickStartv20/aspnet/）的《Examining ASP.NET 2.0's Site Navigation Features》和《Using Site Navigation Controls》部分.


图20：Menu控件列出了所有的Categories 和 Products
就像在本教程前面提到的那样，网站地图结构可以通过SiteMap class类来进行访问，下面的代码返回默认的provider的root SiteMapNode：
SiteMapNode root = SiteMap.RootNode;
由于AspNetXmlSiteMapProvider是默认的provider，上述代码返回的是定义在Web.sitemap文件里的根节点，要引用其它的site map provider的话，使用SiteMap class类的Providers property属性，如：
SiteMapNode root = SiteMap.Providers["name"].RootNode;

这里的name是用户定制的site map provider的名称(就本文而言,为“Northwind”)
要访问某个具体的site map provider，使用SiteMap.Providers["name"]来获取该provider的实例，再将其转换成恰当的类型。比如，要展示NorthwindSiteMapProvider的CachedDate property属性，使用如下的代码：


NorthwindSiteMapProvider customProvider =
 SiteMap.Providers["Northwind"] as NorthwindSiteMapProvider;
if (customProvider != null)
{
 DateTime"Site map cached on: " + lastCachedDate.Value.ToString();
 else
 LabelID.Text = "The site map is being reconstructed!";
}




　　注意：务必测试SQL cache dependency属性，访问完Default.aspx, ProductsByCategory.aspx, 和 ProductDetails.aspx页面后，转到本系列教程的《编辑插入和删除数据》部分的任一个页面，编辑某个category 或 product的名称；然后再转到SiteMapProvider文件夹里的某个页面，假设时间足够长，长到检测机制(polling mechanism)发现“源数据库”已经发生了改动，那么site map应该被更新以显示新的product 或 category名字.
结语：
　　ASP.NET 2.0的site map属性包含一个SiteMap class类，一系列内置的的导航Web控件，以及一个默认的site map provider.为了使用来自某些数据源的site map信息——比如数据库、系统的“层”、或者某些Web服务，我们需要创建一个用户定制的 site map provider.这就要创建一个类，该类直接或间接的源自SiteMapProvider class类.
　　本章我们探讨了如何创建一个用户定制的site map provider，它以一个由product 和 category信息构成的site map为基础.我们的provider对StaticSiteMapProvider class类进行了扩充，并创建了一个BuildSiteMap method方法来获取数据、构建site map的层次体系，并且将最终的网站地图结构缓存在一个“类级”的变量里.我们使用一个SQL cache dependency来确保当Categories 或 Products的“源数据”发生改动时使缓存的数据失效.
　　祝编程快乐！
作者简介
　　本系列教程作者 Scott Mitchell，著有六本ASP/ASP.NET方面的书，是4GuysFromRolla.com的创始人，自1998年以来一直应用 微软Web技术。大家可以点击查看全部教程《[翻译]Scott Mitchell 的ASP.NET 2.0数据教程》，希望对大家的学习ASP.NET有所帮助。