SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Method

Definition

현재 요청 된 페이지에 대 한 노드를 검색 하는 사이트 맵 노드 페치할 현재 노드와 근접 한 위치에서 때 사이트 맵 공급자에 최적화 된 조회 방법을 제공 합니다.Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the site map nodes in the proximity of the current node.

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

Parameters

upLevel
Int32

페치할 상위 SiteMapNode 세대의 수입니다.The number of ancestor SiteMapNode generations to fetch. 0 상위 노드가 검색 되 고 나타냄는 모든 상위 항목은 검색 및 공급자가 캐시 수를 나타냅니다.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors might be retrieved and cached by the provider.

downLevel
Int32

페치할 자식 SiteMapNode 세대의 수입니다.The number of child SiteMapNode generations to fetch. 0 하위 노드가 검색 되 고 모든 하위 노드가 검색 되어를 공급자에 의해 캐시는 나타냄 나타냅니다.0 indicates no descendant nodes are retrieved and a -1 indicates that all descendant nodes 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 또는 downLevel이 -1 미만입니다.upLevel or downLevel is less than -1.

Remarks

그러나 기본 구현을 GetCurrentNodeAndHintNeighborhoodNodes 메서드가 반환 되는 CurrentNode 속성 사이트 맵 공급자가 재정의할 수 있습니다는 GetCurrentNodeAndHintNeighborhoodNodes 메서드 현재 반환할 사용자 지정 캐싱 메커니즘을 사용 하는 최적화 된 구현을 제공 SiteMapNode 개체 뿐만 SiteMapNode 근접 한 현재 위치에 있는 개체 SiteMapNode합니다.The default implementation of the GetCurrentNodeAndHintNeighborhoodNodes method returns the CurrentNode property; however, site map providers can override the GetCurrentNodeAndHintNeighborhoodNodes method and provide an optimized implementation that uses custom caching mechanisms to return the current SiteMapNode object, as well as SiteMapNode objects that are in the proximity of the current SiteMapNode.

upLevel 검색 하 고 캐시에서 즉시 해당 자식과 함께 부모 및 상위 노드 수준의 수를 지정 합니다. 매개 변수를 사용 합니다.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to retrieve and cache, along with their immediate children. 합니다 downLevel 매개 변수는 현재에서 하위 노드의 수준 수를 지정 하는 데 사용 됩니다 SiteMapNode 검색할 합니다.The downLevel parameter is used to specify how many levels of descendant nodes from the current SiteMapNode to retrieve. 상위 및 하위 노드에 연결할 수 있습니다, 원하는 경우는 SiteMapNode 에서 반환 하는 합니다If preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the

GetCurrentNodeAndHintNeighborhoodNodes 메서드를 사용 하는 ParentNodeChildNodes 속성입니다.GetCurrentNodeAndHintNeighborhoodNodes method, using the ParentNode and ChildNodes properties. 더 적은 상위 항목 또는 자식 노드 수준에서 지정 된 수보다 많은 경우 upLevel 또는 downLevel를 사용할 수 있는 항목만 검색 됩니다.If there are fewer ancestor or child node levels than are specified by upLevel or downLevel, only those that are available are retrieved.

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