SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

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

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);

public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);

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

Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

参数

upLevel

Int32

要获取的祖先站点地图节点的代数。 值为 -1 指示提供程序可检索和缓存所有祖先节点。

返回

SiteMapNode

表示当前请求页的 SiteMapNode；否则，如果没有找到或不能为当前用户返回 SiteMapNode，则为 null。

例外

ArgumentOutOfRangeException

upLevel 小于 -1。

注解

该方法的默认实现 GetCurrentNodeAndHintAncestorNodes 返回 CurrentNode 属性;但是，网站地图提供程序可以重写 GetCurrentNodeAndHintAncestorNodes 该方法，并提供一个优化实现，该实现使用自定义缓存机制返回当前 SiteMapNode以及父节点的父节点和上级节点。

此参数 upLevel 用于指定要检索的父节点和上级节点的数量。 如果首选，可以使用属性将父节点和上级节点链接到SiteMapNode方法ParentNode返回GetCurrentNodeAndHintAncestorNodes的对象。

该XmlSiteMapProvider类是 ASP.NET 的默认站点地图提供程序，在内存中缓存整个站点地图，在查询XmlSiteMapProvider特定SiteMapNode对象时会产生很少或没有开销。

另请参阅

• GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)