SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當擷取目前所要求之網頁的節點，以及擷取目前網頁的父代和祖系網站導覽節點時，提供網站導覽提供者的最佳化查閱方法。
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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode參數
- upLevel
- Int32
要取得的祖系網站導覽節點層代數。 -1 值表示提供者可以擷取和快取所有祖系。
傳回
表示目前所要求之網頁的 SiteMapNode，但如果找不到 SiteMapNode 或無法為目前使用者傳回，則為 null。
例外狀況
upLevel 小於 -1。
備註
方法的預設實作 GetCurrentNodeAndHintAncestorNodes 會 CurrentNode 傳回 屬性;不過，網站地圖提供者可以覆寫 GetCurrentNodeAndHintAncestorNodes 方法，並提供優化實作，使用自訂快取機制傳回目前的 SiteMapNode ，以及父代的父代和上階節點。
參數 upLevel 用來指定要擷取的父節點和上階節點層級數目。 如果慣用，可以使用 屬性，將父節點和上階節點連結至 SiteMapNode 方法 ParentNode 所 GetCurrentNodeAndHintAncestorNodes 傳回的物件。
類別 XmlSiteMapProvider 是 ASP.NET 的預設網站地圖提供者，會在記憶體中快取整個網站地圖，這會導致查詢 XmlSiteMapProvider 特定 SiteMapNode 物件的 時產生少量或沒有額外負荷。