StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

向站点地图提供程序维护的集合添加一个 SiteMapNode，并建立 SiteMapNode 对象之间的父/子关系。

protected public:
 override void AddNode(System::Web::SiteMapNode ^ node, System::Web::SiteMapNode ^ parentNode);

protected internal override void AddNode (System.Web.SiteMapNode node, System.Web.SiteMapNode parentNode);

override this.AddNode : System.Web.SiteMapNode * System.Web.SiteMapNode -> unit

Protected Friend Overrides Sub AddNode (node As SiteMapNode, parentNode As SiteMapNode)

参数

node

SiteMapNode

要添加到站点地图提供程序的 SiteMapNode。

parentNode

SiteMapNode

SiteMapNode，将在它的下面添加 node。

例外

ArgumentNullException

node 为 null。

InvalidOperationException

Url 或 Key 已经注册到 StaticSiteMapProvider。 站点地图节点必须由具有唯一 URL 或键的页构成。

注解

由参数标识 node 的站点映射节点将添加到内部集合，并在它与由参数标识 parentNode 的站点映射节点之间创建父子关系。

将站点映射节点的 URL 添加到内部集合时，可能会解释该节点的 URL。 应用程序相对 URL 和相对 URL 扩展为应用程序绝对虚拟路径，然后用于内部存储和访问类的各个 SiteMapNode 实例。 不会解释其他 URL，例如物理路径、具有协议的路径和 UNC 路径。

该XmlSiteMapProvider类派生自StaticSiteMapProvider该类，是 ASP.NET 的默认站点地图提供程序，默认情况下，该Url类在其内部集合中将对象的属性SiteMapNode用作查找键。 如果设置了属性UrlSiteMapNode，则必须在站点地图提供程序的范围内唯一。 该方法 FindSiteMapNode 尝试根据站点 Url 映射节点的属性检索站点映射节点。 否则，可以使用 Key 属性和相应的 FindSiteMapNodeFromKey 方法来检索站点映射节点。 Url如果未指定或Key未指定，则站点地图提供程序自动生成一个用于跟踪站点地图节点的站点Key映射节点。

继承者说明

重写AddNode(SiteMapNode, SiteMapNode)方法时，请确保使用AddNode该方法添加站点地图节点时将Key属性设置为唯一值。

另请参阅

• RemoveNode(SiteMapNode)