StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向站点地图提供程序维护的集合添加一个 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的下 。
例外
node 是 null。
Url或Key已向 .StaticSiteMapProvider. 网站地图节点必须由具有唯一 URL 或键的页面组成。
注解
由 node 参数标识的站点地图节点将添加到内部集合中,并在它与由参数标识 parentNode 的站点地图节点之间创建父子关系。
将站点地图节点的 URL 添加到内部集合时,可能会解释该节点的 URL。 应用程序相对 URL 和相对 URL 扩展为应用程序绝对虚拟路径,然后在内部使用这些路径来存储和访问类的各个 SiteMapNode 实例。 不会解释其他 URL,例如物理路径、包含协议的路径和 UNC 路径。
该类派生自StaticSiteMapProvider该类,是 ASP.NET 的默认站点地图提供程序,默认情况下,Url该XmlSiteMapProvider类使用对象的属性SiteMapNode作为其内部集合中的查找键。 如果设置了该 Url 属性 SiteMapNode ,则它必须在站点地图提供程序的范围内是唯一的。 该方法 FindSiteMapNode 尝试根据其 Url 属性检索站点地图节点。 否则,可以使用 Key 属性和相应的 FindSiteMapNodeFromKey 方法来检索站点地图节点。 Url如果未指定或Key未指定,则站点地图提供程序会自动生成一个Key用于跟踪站点地图节点的站点地图节点。
继承者说明
重写AddNode(SiteMapNode, SiteMapNode)方法时,请确保使用该方法添加站点地图节点AddNode时将该Key属性设置为唯一值。