SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

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

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，但如果找不到 SiteMapNode 或無法為目前使用者傳回，則為 null。

例外狀況

ArgumentOutOfRangeException

upLevel 或 downLevel 小於 -1。

備註

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

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

GetCurrentNodeAndHintNeighborhoodNodes 方法，使用 ParentNode 和 ChildNodes 屬性。 如果上階或子節點層級少於 或 downLevel 所 upLevel 指定，則只會擷取可用的層級。

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

另請參閱

• GetCurrentNodeAndHintAncestorNodes(Int32)