SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

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

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。

例外狀況

ArgumentOutOfRangeException

walkupLevels 或 relativeDepthFromWalkup 小於 0。

備註

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

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

另請參閱

• GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)