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

정의

사이트 맵 공급자가 지정된 노드와 근접한 위치에 있는 노드에 대해 최적화된 검색을 수행하기 위해 재정의할 수 있는 메서드를 제공합니다.Provides a method that site map providers can override to perform an optimized retrieval of nodes found in the proximity of the specified node.

public:
 virtual void HintNeighborhoodNodes(System::Web::SiteMapNode ^ node, int upLevel, int downLevel);
public virtual void HintNeighborhoodNodes (System.Web.SiteMapNode node, int upLevel, int downLevel);
abstract member HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
override this.HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
Public Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel As Integer)

매개 변수

node
SiteMapNode

upLevel에 대한 참조 지점으로 동작할 SiteMapNode입니다.The SiteMapNode that acts as a reference point for upLevel.

upLevel
Int32

페치할 상위 SiteMapNode 세대의 수입니다.The number of ancestor SiteMapNode generations to fetch. 0은 상위 노드가 검색되지 않음을 나타내고 -1은 모든 상위 노드 및 node 수준의 하위 노드가 검색되어 캐시됨을 나타냅니다.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors (and their descendant nodes to the level of node) might be retrieved and cached.

downLevel
Int32

페치할 하위 SiteMapNode 세대의 수입니다.The number of descendant SiteMapNode generations to fetch. 0은 하위 노드가 검색되지 않음을 나타내고 -1은 모든 하위 노드가 검색되어 캐시됨을 나타냅니다.0 indicates no descendant nodes are retrieved and -1 indicates that all descendant nodes might be retrieved and cached.

예외

upLevel 또는 downLevel이 -1 미만입니다.upLevel or downLevel is less than -1.

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

설명

기본값 HintNeighborhoodNodes 확인만 메서드를 upLeveldownLevel -1 보다 작을 수 있는 매개 변수 및 node 는 매개 변수가 null합니다.The default HintNeighborhoodNodes method only checks for an upLevel and downLevel parameters that are less than -1 and a node parameter that is null. 때문에 XmlSiteMapProvider 개체는 사이트 맵 정보를 메모리에 캐시 된 HintNeighborhoodNodes 메서드가 사용 되지 않습니다.Because the XmlSiteMapProvider object caches site map information in memory, the HintNeighborhoodNodes method is not used.

사이트 맵 공급자가 재정의할 수는 HintNeighborhoodNodes 의 최적화 된 조회를 수행 하는 메서드를 SiteMapNode 근접 한 위치에서 지정 된 개체 SiteMapNode합니다.Site map providers can override the HintNeighborhoodNodes method to perform an optimized lookup of the SiteMapNode objects in the proximity of the specified SiteMapNode. 합니다 upLevel 매개 변수에서 지정 된 이동할 부모 및 상위 노드 수준의 수를 지정 하는 SiteMapNode합니다.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to traverse from the specified SiteMapNode. downLevel 검색할 현재 노드의 자식 노드 수준의 수를 지정 합니다. 매개 변수를 사용 합니다.The downLevel parameter is used to specify how many levels of child nodes from the current node to retrieve. 상위 및 하위 노드를 원하는 경우에 연결할 수 있습니다는 SiteMapNode 에서 반환 하는 합니다 HintNeighborhoodNodes 메서드를 사용 하 여는 ParentNodeChildNodes 속성입니다.If preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the HintNeighborhoodNodes method, using the ParentNode and ChildNodes properties.

적용 대상

추가 정보