SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 metodu, kterou můžou poskytovatelé map webu přepsat, aby provedli optimalizované načtení jedné nebo více úrovní nadřazených a nadřazených uzlů vzhledem k zadanému SiteMapNode objektu.
public:
virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)Parametry
- node
- SiteMapNode
To SiteMapNode funguje jako referenční bod pro upLevel.
- upLevel
- Int32
Počet předků SiteMapNode , které se mají načíst. 0 označuje, že nejsou načteny žádné nadřazené uzly a -1 označuje, že všechny nadřazené položky mohou být načteny a uloženy do mezipaměti.
Výjimky
upLevel je menší než -1.
node je null.
Poznámky
Výchozí HintAncestorNodes metoda kontroluje upLevel pouze parametr, který je menší než -1, a node parametr, který je null. Vzhledem k tomu, že XmlSiteMapProvider třída ukládá informace o mapě webu do paměti, HintAncestorNodes metoda se nepoužívá.
Poskytovatelé map webu mohou metodu HintAncestorNodes přepsat, aby provedli optimalizované načtení nadřazených a nadřazených uzlů zadaného SiteMapNode objektu.
Parametr upLevel slouží k určení počtu úrovní nadřazených a nadřazených uzlů, které se mají procházet ze zadaného SiteMapNodeuzlu . Pokud existuje méně úrovní, než je požadováno, vrátí se všechny dostupné nadřazené uzly v zadané vazbě. Pokud je to upřednostňované, nadřazený uzel lze propojit se zadaným SiteMapNode použitím ParentNode vlastnosti.