SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在站点地图提供程序检索指定 SiteMapNode 对象的祖先节点并获取其子节点时，为其提供经优化的查找方法。
public:
virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNodePublic Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode参数
- node
- SiteMapNode
SiteMapNode，用作 walkupLevels 和 relativeDepthFromWalkup 的参考点。
- walkupLevels
- Int32
在检索请求的祖先节点时要遍历的祖先节点的层次数。
- relativeDepthFromWalkup
- Int32
要从目标祖先节点检索的子代节点的层次数。
返回
表示 node 的祖先的 SiteMapNode；如果未找到或者无法为当前用户返回当前或祖先 SiteMapNode，则为 null。
例外
为 walkupLevels 或 relativeDepthFromWalkup 指定的值小于 0。
node 为 null。
注解
类的默认实现提供该方法的非优化实现SiteMapProviderGetParentNodeRelativeToNodeAndHintDownFromParent，调用HintAncestorNodes和HintNeighborhoodNodes方法;但是，站点地图提供程序可以重写GetParentNodeRelativeToNodeAndHintDownFromParent该方法，并提供一个优化实现，该实现使用自定义缓存机制返回上级节点并执行对其他SiteMapNode对象的优化查找。 该方法 GetParentNodeRelativeToNodeAndHintDownFromParent 与该方法非常相似 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 。
此参数 walkupLevels 用于指定检索目标节点时要遍历的父节点和上级节点的数量。 如果存在比请求的级别少， null 则返回。 此参数 downLevel 用于指定要从目标上级节点检索的后代节点的数量。 如果首选，可以使用和属性将 SiteMapNode 上级节点和后代节点链接到方法返回 GetParentNodeRelativeToNodeAndHintDownFromParent 的 ParentNode 节点 ChildNodes 。 如果上级节点级别少于参数指定的 upLevel 上级节点级别， null 则返回。 由提供程序实现者决定如何处理可用后代节点级别数小于参数指定的 downLevel 值的情况。