SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Poskytuje optimalizovanou metodu vyhledávání pro poskytovatele mapy webu při načítání uzlu pro aktuálně požadovanou stránku a načítání uzlů mapy webu v blízkosti aktuálního uzlu.

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

Parametry

upLevel

Int32

Počet generací předchůdců SiteMapNode , které se mají načíst. 0 znamená, že se nenačtou žádné nadřazené uzly a -1 znamená, že zprostředkovatel může načíst a uložit do mezipaměti všechny nadřazené uzly.

downLevel

Int32

Počet podřízených SiteMapNode generací, které se mají načíst. 0 znamená, že nejsou načteny žádné podřízené uzly a -1 označuje, že zprostředkovatel může načíst a uložit do mezipaměti všechny podřízené uzly.

Návraty

SiteMapNode

A SiteMapNode , která představuje aktuálně požadovanou stránku; v opačném případě , nullpokud SiteMapNode není nalezena nebo nemůže být vrácena pro aktuálního uživatele.

Výjimky

ArgumentOutOfRangeException

upLevel nebo downLevel je menší než -1.

Poznámky

Výchozí implementace GetCurrentNodeAndHintNeighborhoodNodes metody vrátí CurrentNode vlastnost. Zprostředkovatelé mapy webu však mohou přepsat metodu GetCurrentNodeAndHintNeighborhoodNodes a poskytnout optimalizovanou implementaci, která používá vlastní mechanismy ukládání do mezipaměti k vrácení aktuálního SiteMapNode objektu, stejně jako SiteMapNode objekty, které jsou v blízkosti aktuálního SiteMapNodeobjektu .

Parametr upLevel slouží k určení, kolik úrovní nadřazených a nadřazených uzlů se má načíst a uložit do mezipaměti spolu s jejich bezprostředními podřízenými uzly. Parametr downLevel slouží k určení, kolik úrovní následnických uzlů z aktuálního stavu SiteMapNode se má načíst. V případě potřeby lze nadřazený a následný uzel propojit s SiteMapNode uzlem, který je vrácen

GetCurrentNodeAndHintNeighborhoodNodesParentNode pomocí vlastností aChildNodes. Pokud existuje méně úrovní nadřazených nebo podřízených uzlů, než je určeno pomocí upLevel nebo downLevel, načtou se pouze ty, které jsou k dispozici.

Třída XmlSiteMapProvider , která je výchozím zprostředkovatelem mapy webu pro ASP.NET, ukládá celou mapu webu do mezipaměti, což vede k malým nebo žádným režijním nákladům při dotazování XmlSiteMapProvider na konkrétní SiteMapNode objekty.

Viz také

• GetCurrentNodeAndHintAncestorNodes(Int32)