WSS3SDK之：通过对象模型添加链接

WSS使用标准的ASP.NET控件来导航。比如，System.Web.SiteMapNode类用于SharePoint页面顶部左侧的全局面包屑(global breadcrumbs)。Menu控件同时用在顶部导航链接和快速导航链接中，SharePoint中导航的层次是通过System.Web.SiteMapProvider类来组织。自定义导航控件，如Treeview，Menu，和SiteMapPath控件，可以绑定到该provider上。
我们可以使用Microsoft.SharePoint.Navigation命名空间下的类型和方法来定制站点的导航。通过WSS对象模型我们可以管理快速启动、顶部导航区域，改变链接顺序，添加新链接或删除链接。也可以管理网站同父网站间的继承关系。
Microsoft.SharePoint.SPWeb类的Navigation属性可以获取一个Microsoft.SharePoint.Navigation.SPNavigation对象。该对象包括了指定站点的所有导航属性，与父网站的导航继承关系，以及页面层次关系和导航结点的集合。SPNavigation对象的QuickLaunch属性返回快速导航区中找到的导航结点的集合，Web属性可以得到父网站集的顶级根站点，TopNavigationBar属性返回代表顶部导航栏所有导航结点的集合。一个SPNavigationNodeCollection对象代表了相当给定对象的一个有序的导航结点的集合，并提供了通过编程添加、删除结点的能力。
注意通过SPNavigationNode对象可以包含任意的URL，对于此种类型的链接，可以执行链接修正(link fix-up)。可对于网站集中文档和页面的URL的包含，是支持链接修正的。

示例

下面的例子将创建一个链接，并添加到快速启动的最上面。
VB

Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteCollection.AllWebs("TestSite")
Dim subSite As SPWeb = site.Webs("SubTestSite")

Dim nodes As SPNavigationNodeCollection = subSite.Navigation.QuickLaunch
Dim navNode As New SPNavigationNode("New Link", "http://www.msn.com", True)
nodes.AddAsFirst(navNode)

SPSite siteCollection = SPControl.GetContextSite(Context);
SPWeb site = siteCollection.AllWebs["TestSite"];
SPWeb subSite = site.Webs["SubTestSite"];

SPNavigationNodeCollection nodes = subSite.Navigation.QuickLaunch;
SPNavigationNode navNode = new SPNavigationNode("New Link", "http://www.msn.com", true);
nodes.AddAsFirst(navNode);

SPNavigationNode构造器的第三个参数设为true是因为新添加的链接URL是该SharePoint部署之外的。
由于该代码含有变更内容数据库的操作，所以在运行该代码的.aspx页面里，要有一个Microsoft.SharePoint.WebControls.FormDigest控件(可以放在一个WebPart里运行，Web部件页里自带该控件。也可以在一般的aspx页面中的Form标签中添加该控件，以便在页面中运行该代码)。同时，别忘了引用Microsoft.SharePoint和Microsoft.SharePoint.WebControls命名空间。