SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) 메서드

정의

지정된 SiteMapNode 개체를 기준으로 하여 부모 및 상위 노드의 여러 수준을 최적화 상태로 검색하기 위해 사이트 맵 공급자가 재정의할 수 있는 메서드를 제공합니다.Provides a method that site map providers can override to perform an optimized retrieval of one or more levels of parent and ancestor nodes, relative to the specified SiteMapNode object.

public:
 virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);
public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);
abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unit
Public Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel 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은 모든 상위 노드가 검색되어 캐시됨을 나타냅니다.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors might be retrieved and cached.

예외

upLevel이 -1보다 작습니다.upLevel is less than -1.

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

설명

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

사이트 맵 공급자가 재정의할 수는 HintAncestorNodes 메서드는 지정 된 부모 및 상위 노드 최적화 상태로 검색을 수행 하도록 SiteMapNode 개체입니다.Site map providers can override the HintAncestorNodes method to perform an optimized retrieval of parent and ancestor nodes of the specified SiteMapNode object.

합니다 upLevel 매개 변수에서 지정 된 이동할 부모 및 상위 노드 수준의 수를 지정 하는 SiteMapNode합니다.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to traverse from the specified SiteMapNode. 요청 된 것 보다 더 적은 수준 존재 하는 경우 지정된 된 범위 내에서 모든 사용 가능한 상위 노드가 반환 됩니다.If fewer levels exist than are requested, all available ancestor nodes are returned within the specified bound. 부모 노드를 연결할 수 있습니다, 원하는 경우 지정 된 SiteMapNode 를 사용 하 여는 ParentNode 속성입니다.If preferred, the parent node can be linked to the specified SiteMapNode using the ParentNode property.

적용 대상

추가 정보