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

정의

지정된 SiteMapNode 개체에 대한 상위 노드를 검색하고 해당 자식 노드를 페치할 때 사이트 맵 공급자에 최적화된 조회 방법을 제공합니다.Provides an optimized lookup method for site map providers when retrieving an ancestor node for the specified SiteMapNode object and fetching its child nodes.

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입니다.The SiteMapNode that acts as a reference point for walkupLevels and relativeDepthFromWalkup.

walkupLevels
Int32

요청된 상위 노드를 검색할 때 이동할 상위 노드 수준의 수입니다.The number of ancestor node levels to traverse when retrieving the requested ancestor node.

relativeDepthFromWalkup
Int32

대상 상위 노드로부터 검색할 하위 노드의 수준 수입니다.The number of descendant node levels to retrieve from the target ancestor node.

반환

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.

예외

walkupLevels 또는 relativeDepthFromWalkup에 대해 지정된 값이 0보다 작은 경우The value specified for walkupLevels or relativeDepthFromWalkup is less than 0.

node이(가) null인 경우node is null.

설명

그러나 기본 구현을 SiteMapProvider 클래스의 비 최적화 구현을 제공 합니다 GetParentNodeRelativeToNodeAndHintDownFromParent 메서드를 호출은 HintAncestorNodesHintNeighborhoodNodes 메서드를 사이트 맵 공급자가 재정의할 수 있습니다는 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 메서드를 사용 하 여는 ParentNodeChildNodes 속성입니다.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.

적용 대상

추가 정보