SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller en metod som webbplatsöversiktsproviders kan åsidosätta för att utföra en optimerad hämtning av en eller flera nivåer av överordnade och överordnade noder i förhållande till det angivna SiteMapNode objektet.
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 -> unit
Public Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)
Parametrar
- node
- SiteMapNode
Som SiteMapNode fungerar som en referenspunkt för upLevel.
- upLevel
- Int32
Antalet förfadergenerationer SiteMapNode som ska hämtas. 0 anger att inga överordnade noder hämtas och -1 anger att alla överordnade kan hämtas och cachelagras.
Undantag
upLevel är mindre än -1.
node är null.
Kommentarer
HintAncestorNodes Standardmetoden söker bara efter en upLevel parameter som är mindre än -1 och en node parameter som är null.
XmlSiteMapProvider Eftersom klassen cachelagrar platsmappningsinformation i minnet HintAncestorNodes används inte metoden.
Webbplatsöversiktsproviders kan åsidosätta HintAncestorNodes metoden för att utföra en optimerad hämtning av överordnade och överordnade noder för det angivna SiteMapNode objektet.
Parametern upLevel används för att ange hur många nivåer av överordnade och överordnade noder som ska passera från den angivna SiteMapNode. Om det finns färre nivåer än vad som begärs returneras alla tillgängliga överordnade noder inom den angivna gränsen. Om så önskas kan den överordnade noden länkas till den angivna SiteMapNode med hjälp av ParentNode egenskapen .