SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 方法

定義

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

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

參數

walkupLevels
Int32

當擷取所要求之祖系節點時,要周遊的祖系節點層級數。

relativeDepthFromWalkup
Int32

要從目標祖系節點開始擷取的子代節點層級數。

傳回

SiteMapNode

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

例外狀況

walkupLevelsrelativeDepthFromWalkup 小於 0。

備註

類別的預設實作 SiteMapProvider 提供方法的非優化實 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 作,呼叫 GetCurrentNodeAndHintAncestorNodesHintNeighborhoodNodes 方法;不過,網站地圖提供者可以覆寫 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 方法,並提供優化實作,使用自訂快取機制傳回上階節點並執行其他 SiteMapNode 物件的優化查閱。

參數 walkupLevels 用來指定擷取目標節點時要周遊的父節點和上階節點層級數目。 如果層級少於所要求的層級, null 則會傳回 。 參數 downLevel 可用來指定要從目標上階節點擷取多少層級的子系節點。 如果慣用,則上階和子系節點可以使用 和 屬性連結到 SiteMapNode 方法所傳回的 ParentNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParentChildNodes

適用於

另請參閱