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 方法所傳回的 ParentNodeHintNeighborhoodNodes 。 ChildNodes

另請參閱

• HintAncestorNodes(SiteMapNode, Int32)