共用方式為


SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) 方法

定義

當擷取目前所要求之網頁的節點,以及擷取目前節點附近的網站導覽節點時,提供網站導覽提供者的最佳化查閱方法。

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);
abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

參數

upLevel
Int32

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

downLevel
Int32

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

傳回

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

例外狀況

upLeveldownLevel 小於 -1。

備註

方法的預設實作 GetCurrentNodeAndHintNeighborhoodNodesCurrentNode 傳回 屬性;不過,網站地圖提供者可以覆寫 GetCurrentNodeAndHintNeighborhoodNodes 方法,並提供使用自訂快取機制傳回目前 SiteMapNodeSiteMapNode 物件的優化實作,以及 SiteMapNode 目前 鄰近的物件。

參數 upLevel 可用來指定要擷取和快取的父節點和祖系節點層級,以及其立即子系的數目。 參數 downLevel 可用來指定要從目前 SiteMapNode 擷取的子系節點層級數目。 如果慣用,則上階和子系節點可以連結至 SiteMapNode 所傳回的

GetCurrentNodeAndHintNeighborhoodNodes 方法,使用 ParentNodeChildNodes 屬性。 如果上階或子節點層級少於 或 downLevelupLevel 指定,則只會擷取可用的層級。

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

適用於

另請參閱