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

GetCurrentNodeAndHintNeighborhoodNodes ParentNode 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)