SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當擷取指定 SiteMapNode 物件的祖系節點，以及擷取其子節點時，提供網站導覽提供者的最佳化查閱方法。
public:
virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNodePublic Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode參數
- node
- SiteMapNode
SiteMapNode，做為 walkupLevels 和 relativeDepthFromWalkup 的參考點。
- walkupLevels
- Int32
當擷取所要求之祖系節點時，要周遊的祖系節點層級數。
- relativeDepthFromWalkup
- Int32
要從目標祖系節點開始擷取的子代節點層級數。
傳回
SiteMapNode，表示 node 的祖系，但如果找不到目前或祖系 SiteMapNode 或無法為目前使用者傳回，則為 null。
例外狀況
walkupLevels 或 relativeDepthFromWalkup 的指定值小於 0。
node 為 null。
備註
類別的預設實作 SiteMapProvider 提供方法的非優化實 GetParentNodeRelativeToNodeAndHintDownFromParent 作，呼叫 HintAncestorNodes 和 HintNeighborhoodNodes 方法;不過，網站地圖提供者可以覆寫 GetParentNodeRelativeToNodeAndHintDownFromParent 方法，並提供優化實作，使用自訂快取機制傳回上階節點並執行其他 SiteMapNode 物件的優化查閱。 方法 GetParentNodeRelativeToNodeAndHintDownFromParent 與 方法非常類似 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 。
參數 walkupLevels 用來指定擷取目標節點時要周遊的父節點和上階節點層級數目。 如果層級少於所要求的層級， null 則會傳回 。 參數 downLevel 可用來指定要從目標上階節點擷取多少層級的子系節點。 如果慣用，則上階和子系節點可以使用 和 屬性連結到 SiteMapNode 方法所傳回的 ParentNode GetParentNodeRelativeToNodeAndHintDownFromParent 。 ChildNodes 如果上階節點層級少於 參數所 upLevel 指定的層級， null 則會傳回 。 提供者實作者決定如何處理可用的子代節點層級數目小於 參數所 downLevel 指定的值的情況。