SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供方法，讓網站導覽提供者可以覆寫，以最佳化方式擷取相對於指定 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)

SiteMapNode，做為 upLevel 的參考點。

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

upLevel 小於 -1。

node 為 null。

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

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

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