SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent 메서드

정의

지정된 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.SiteMapNode
Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

매개 변수

node
SiteMapNode

walkupLevelsrelativeDepthFromWalkup에 대한 참조 지점으로 동작할 SiteMapNode입니다.

walkupLevels
Int32

요청된 상위 노드를 검색할 때 이동할 상위 노드 수준의 수입니다.

relativeDepthFromWalkup
Int32

대상 상위 노드로부터 검색할 하위 노드의 수준 수입니다.

반환

SiteMapNode

node의 상위 노드를 나타내는 SiteMapNode이거나, 그렇지 않고 현재 또는 상위 SiteMapNode가 없거나 현재 사용자에 대해 반환될 수 없으면 null입니다.

예외

walkupLevels 또는 relativeDepthFromWalkup에 대해 지정된 값이 0보다 작은 경우

node이(가) null인 경우

설명

그러나 기본 구현을 SiteMapProvider 클래스의 비 최적화 구현을 제공 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드를 호출은 HintAncestorNodesHintNeighborhoodNodes 메서드를 사이트 맵 공급자가 재정의할 수 있습니다는 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드 및 사용자 지정 캐싱 메커니즘을 사용 하 여 상위 노드를 반환 하 고 다른 최적화 된 조회를 실행 하는 최적화 된 구현을 제공 SiteMapNode 개체입니다. 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드는 매우 비슷합니다는 GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 메서드.

walkupLevels 매개 변수를 사용 하는 대상 노드를 검색할 때 이동할 부모 및 상위 노드 수준의 수를 지정 합니다. 요청 된 것 보다 더 적은 수준 수가 null 반환 됩니다. downLevel 매개 변수는 대상 상위 노드로부터 검색할 하위 노드의 수준 수를 지정 하는 데 사용 됩니다. 상위 및 하위 노드를 원하는 경우에 연결할 수 있습니다는 SiteMapNode 에서 반환 하는 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드를 사용 하 여는 ParentNodeChildNodes 속성입니다. 지정한 것 보다 더 적은 상위 노드 수준의 경우 합니다 upLevel 매개 변수를 null 반환 됩니다. 공급자 구현 자가 사용할 수 있는 하위 노드의 수준 수는 지정 된 값 보다 작으면 상황을 처리 하는 방법을 결정 하는 것은 downLevel 매개 변수입니다.

적용 대상

추가 정보