SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

提供一个方法，站点地图提供程序可以重写该方法以执行在指定节点附近找到的节点的经优化的检索。

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

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

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

Public Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel As Integer)

参数

node

SiteMapNode

SiteMapNode，用作 upLevel 的参考点。

upLevel

Int32

要获取的祖先 SiteMapNode 的代数。 0 指示不检索祖先节点，-1 指示可检索和缓存所有祖先节点（及其到 node 层次的子代节点）。

downLevel

Int32

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

例外

ArgumentOutOfRangeException

upLevel 或 downLevel 小于 -1。

ArgumentNullException

node 为 null。

注解

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

站点地图提供程序可以重写 方法，HintNeighborhoodNodes以对指定 SiteMapNode邻近的 对象执行优化查找SiteMapNode。 参数 upLevel 用于指定要从指定的 SiteMapNode遍历多少个级别的父节点和上级节点。 参数 downLevel 用于指定要从当前节点检索多少个级别的子节点。 如果需要，可以使用 和 属性将SiteMapNode上级节点和后代节点链接到 方法ParentNode返回HintNeighborhoodNodes的 。ChildNodes

另请参阅

• HintAncestorNodes(SiteMapNode, Int32)