SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje optimalizovanou metodu vyhledávání pro zprostředkovatele map webu při načítání uzlu pro aktuálně požadovanou stránku a načítání nadřazených a nadřazených uzlů mapy webu pro aktuální stránku.
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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParametry
- upLevel
- Int32
Počet předků mapových uzlů webu, které se mají získat. Hodnota -1 označuje, že poskytovatel může načíst a uložit všechny předky do mezipaměti.
Návraty
A SiteMapNode , která představuje aktuálně požadovanou stránku; v opačném případě , nullpokud SiteMapNode nebyl nalezen nebo nelze vrátit aktuálního uživatele.
Výjimky
upLevel je menší než -1.
Poznámky
Výchozí implementace GetCurrentNodeAndHintAncestorNodes metody vrátí CurrentNode vlastnost, ale zprostředkovatelé map webu mohou přepsat GetCurrentNodeAndHintAncestorNodes metodu a poskytnout optimalizovanou implementaci, která používá vlastní mechanismy ukládání do mezipaměti k vrácení aktuálního SiteMapNodea nadřazeného a nadřazeného uzlu nadřazeného objektu.
Parametr upLevel slouží k určení počtu úrovní nadřazených a nadřazených uzlů, které se mají načíst. Pokud je to upřednostňované, nadřazené a nadřazené uzly mohou být propojeny s SiteMapNode objektem vráceným metodou GetCurrentNodeAndHintAncestorNodes pomocí ParentNode vlastnosti.
TřídaXmlSiteMapProvider, která je výchozím poskytovatelem map webů pro ASP.NET, ukládá celou mapu webu do mezipaměti, což má za následek minimální nebo žádnou režii při dotazování XmlSiteMapProvider na konkrétní SiteMapNode objekty.