SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32) 메서드

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.SiteMapNode

Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

매개 변수

반환

SiteMapNode

node의 상위 노드를 나타내는 SiteMapNode이거나, 그렇지 않고 현재 또는 상위 SiteMapNode가 없거나 현재 사용자에 대해 반환될 수 없으면 null입니다.A SiteMapNode that represents an ancestor of node; otherwise, null, if the current or ancestor SiteMapNode is not found or cannot be returned for the current user.

예외

설명

그러나 기본 구현을 SiteMapProvider 클래스의 비 최적화 구현을 제공 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드를 호출은 HintAncestorNodes 및 HintNeighborhoodNodes 메서드를 사이트 맵 공급자가 재정의할 수 있습니다는 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드 및 사용자 지정 캐싱 메커니즘을 사용 하 여 상위 노드를 반환 하 고 다른 최적화 된 조회를 실행 하는 최적화 된 구현을 제공 SiteMapNode 개체입니다.The default implementation of the SiteMapProvider class provides a non-optimized implementation of the GetParentNodeRelativeToNodeAndHintDownFromParent method, calling the HintAncestorNodes and HintNeighborhoodNodes methods; however, site map providers can override the GetParentNodeRelativeToNodeAndHintDownFromParent method and provide an optimized implementation that uses custom caching mechanisms to return the ancestor node and perform an optimized lookup of the other SiteMapNode objects. 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드는 매우 비슷합니다는 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 메서드.The GetParentNodeRelativeToNodeAndHintDownFromParent method is very similar to the GetParentNodeRelativeToCurrentNodeAndHintDownFromParent method.

walkupLevels 매개 변수를 사용 하는 대상 노드를 검색할 때 이동할 부모 및 상위 노드 수준의 수를 지정 합니다.The walkupLevels parameter is used to specify how many levels of parent and ancestor nodes to traverse when retrieving the target node. 요청 된 것 보다 더 적은 수준 수가 null 반환 됩니다.If fewer levels exist than are requested, null is returned. downLevel 매개 변수는 대상 상위 노드로부터 검색할 하위 노드의 수준 수를 지정 하는 데 사용 됩니다.The downLevel parameter is used to specify how many levels of descendant nodes from the target ancestor node to retrieve. 상위 및 하위 노드를 원하는 경우에 연결할 수 있습니다는 SiteMapNode 에서 반환 하는 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드를 사용 하 여는 ParentNode 및 ChildNodes 속성입니다.If preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the GetParentNodeRelativeToNodeAndHintDownFromParent method, using the ParentNode and ChildNodes properties. 지정한 것 보다 더 적은 상위 노드 수준의 경우 합니다 upLevel 매개 변수를 null 반환 됩니다.If there are fewer ancestor node levels than specified by the upLevel parameter, null is returned. 공급자 구현 자가 사용할 수 있는 하위 노드의 수준 수는 지정 된 값 보다 작으면 상황을 처리 하는 방법을 결정 하는 것은 downLevel 매개 변수입니다.It is up to the provider implementer to decide how to handle the situation where the number of available descendant node levels is less than the value that is specified by the downLevel parameter.

적용 대상

추가 정보

• GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32)