SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

在站点地图提供程序检索当前请求页的祖先节点并获取其子代节点时，为其提供经优化的查找方法。

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);

public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (int walkupLevels, int relativeDepthFromWalkup);

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

Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

参数

walkupLevels

Int32

在检索请求的祖先节点时要遍历的祖先节点的层次数。

relativeDepthFromWalkup

Int32

要从目标祖先节点检索的子代节点的层次数。

返回

SiteMapNode

表示当前请求页的祖先 SiteMapNode 的 SiteMapNode；如果未找到或无法为当前用户返回当前或祖先 SiteMapNode，则为 null。

例外

ArgumentOutOfRangeException

walkupLevels 或 relativeDepthFromWalkup 小于 0。

注解

类的默认实现提供该方法的非优化实现SiteMapProviderGetParentNodeRelativeToCurrentNodeAndHintDownFromParent，调用GetCurrentNodeAndHintAncestorNodes和HintNeighborhoodNodes方法;但是，站点地图提供程序可以重写GetParentNodeRelativeToCurrentNodeAndHintDownFromParent该方法，并提供一个优化实现，该实现使用自定义缓存机制返回上级节点并执行对其他SiteMapNode对象的优化查找。

此参数 walkupLevels 用于指定检索目标节点时要遍历的父节点和上级节点的数量。 如果存在比请求的级别少， null 则返回。 此参数 downLevel 用于指定要从目标上级节点检索的后代节点的数量。 如果首选，可以使用和属性将 SiteMapNode 上级节点和后代节点链接到方法返回 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 的 ParentNode 节点 ChildNodes 。

另请参阅

• GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)