共用方式為


SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) 方法

定義

提供方法,讓網站導覽提供者可以覆寫,以最佳化方式擷取相對於指定 SiteMapNode 物件的一或多個層級之父代和祖系節點。

public:
 virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);
public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);
abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unit
Public Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)

參數

node
SiteMapNode

SiteMapNode,做為 upLevel 的參考點。

upLevel
Int32

要擷取的祖系 SiteMapNode 層代數。 0 表示不擷取任何祖系節點,而 -1 則表示可以擷取和快取所有祖系。

例外狀況

upLevel 小於 -1。

nodenull

備註

預設 HintAncestorNodes 方法只會檢查 upLevel 小於 -1 的參數,以及 nodenull 的參數。 因為 類別會 XmlSiteMapProvider 快取記憶體中的網站地圖資訊, HintAncestorNodes 所以不會使用 方法。

網站地圖提供者可以覆寫 HintAncestorNodes 方法來執行指定 SiteMapNode 物件的父節點和上階節點的優化擷取。

參數 upLevel 是用來指定要從指定的 SiteMapNode 周遊的父節點和上階節點層級數目。 如果層級少於所要求的層級,則會在指定的界限內傳回所有可用的上階節點。 如果慣用,則父節點可以使用 屬性連結到指定的 SiteMapNode ParentNode

適用於

另請參閱