SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) 메서드

정의

현재 요청된 페이지의 노드를 검색하고 현재 페이지의 부모 및 상위 사이트 맵 노드를 페치할 때 사이트 맵 공급자에 최적화된 조회 방법을 제공합니다.Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the parent and ancestor site map nodes for the current page.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);
abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

매개 변수

upLevel
Int32

가져올 상위 사이트 맵 노드 세대의 수입니다.The number of ancestor site map node generations to get. 값 -1은 공급자가 모든 상위 노드를 검색 및 캐시할 수 있음을 나타냅니다.A value of -1 indicates that all ancestors might be retrieved and cached by the provider.

반환

SiteMapNode

현재 요청된 페이지를 나타내는 SiteMapNode이거나, 그렇지 않고 SiteMapNode가 없거나 현재 사용자에 대해 반환될 수 없으면 null입니다.A SiteMapNode that represents the currently requested page; otherwise, null, if the SiteMapNode is not found or cannot be returned for the current user.

예외

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

설명

그러나 기본 구현을 GetCurrentNodeAndHintAncestorNodes 메서드가 반환 되는 CurrentNode 속성 사이트 맵 공급자가 재정의할 수 있습니다는 GetCurrentNodeAndHintAncestorNodes 메서드 현재 반환할 사용자 지정 캐싱 메커니즘을 사용 하는 최적화 된 구현을 제공 SiteMapNode, 부모의 부모 및 상위 노드 및 합니다.The default implementation of the GetCurrentNodeAndHintAncestorNodes method returns the CurrentNode property; however, site map providers can override the GetCurrentNodeAndHintAncestorNodes method and provide an optimized implementation that uses custom caching mechanisms to return the current SiteMapNode, as well as the parent and ancestor nodes of the parent.

upLevel 검색할 부모 및 상위 노드 수준의 수를 지정 합니다. 매개 변수를 사용 합니다.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to retrieve. 부모 및 상위 노드를 원하는 경우에 연결할 수 있습니다는 SiteMapNode 에서 반환 되는 개체를 GetCurrentNodeAndHintAncestorNodes 메서드를 사용 하 여는 ParentNode 속성입니다.If preferred, the parent and ancestor nodes can be linked to the SiteMapNode object that is returned by the GetCurrentNodeAndHintAncestorNodes method, using the ParentNode property.

XmlSiteMapProvider 클래스를 ASP.NET에 대 한 기본 사이트 맵 공급자가 사이트 맵 전체를 쿼리할 때 거의 또는 전혀 오버 헤드는 메모리에 캐시 합니다 XmlSiteMapProvider 특정 SiteMapNode 개체입니다.The XmlSiteMapProvider class, which is the default site map provider for ASP.NET, caches the entire site map in memory, which results in little or no overhead when querying the XmlSiteMapProvider for specific SiteMapNode objects.

적용 대상

추가 정보