SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Method

Definition

현재 요청 된 페이지에 대 한 노드를 검색 하는 부모 및 상위 사이트 맵 노드 페치할 현재 페이지에 대 한 때 사이트 맵 공급자에 최적화 된 조회 방법을 제공 합니다.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

Parameters

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.

Returns

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.

Exceptions

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

Remarks

그러나 기본 구현을 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.

Applies to

See also