SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

當擷取目前所要求之網頁的節點，以及擷取目前網頁的父代和祖系網站導覽節點時，提供網站導覽提供者的最佳化查閱方法。

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.SiteMapNode

Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

參數

upLevel

Int32

要取得的祖系網站導覽節點層代數。 -1 值表示提供者可以擷取和快取所有祖系。

傳回

SiteMapNode

表示目前所要求之網頁的 SiteMapNode，但如果找不到 SiteMapNode 或無法為目前使用者傳回，則為 null。

例外狀況

ArgumentOutOfRangeException

upLevel 小於 -1。

備註

方法的預設實作 GetCurrentNodeAndHintAncestorNodes 會 CurrentNode 傳回 屬性;不過，網站地圖提供者可以覆寫 GetCurrentNodeAndHintAncestorNodes 方法，並提供優化實作，使用自訂快取機制傳回目前的 SiteMapNode ，以及父代的父代和上階節點。

參數 upLevel 用來指定要擷取的父節點和上階節點層級數目。 如果慣用，可以使用 屬性，將父節點和上階節點連結至 SiteMapNode 方法 ParentNode 所 GetCurrentNodeAndHintAncestorNodes 傳回的物件。

類別 XmlSiteMapProvider 是 ASP.NET 的預設網站地圖提供者，會在記憶體中快取整個網站地圖，這會導致查詢 XmlSiteMapProvider 特定 SiteMapNode 物件的 時產生少量或沒有額外負荷。

另請參閱

• GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)