SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

提供一个方法，站点地图提供程序重写该方法来执行相对于指定 SiteMapNode 对象的一个或多个层次的父和祖先节点的经优化的检索。

public:
 virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);

public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);

abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unit

Public Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)

SiteMapNode，用作 upLevel 的参考点。

要获取的祖先 SiteMapNode 的代数。 0 指示不检索祖先节点，-1 指示可检索和缓存所有祖先节点。

upLevel 小于 -1。

node 为 null。

默认 HintAncestorNodes 方法仅检查 upLevel 小于 -1 的参数和 node 参数 null。 XmlSiteMapProvider由于类缓存内存中的站点地图信息，HintAncestorNodes因此不使用该方法。

网站地图提供程序可以重写 HintAncestorNodes 该方法，以对指定 SiteMapNode 对象的父节点和上级节点执行优化检索。

此参数 upLevel 用于指定要从指定 SiteMapNode节点遍历的父节点和上级节点的数量。如果级别比请求的级别少，则会在指定的边界内返回所有可用的上级节点。如果首选，可以使用属性链接到指定的SiteMapNode ParentNode父节点。