SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Metod

Definition

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 .

Gäller för

Se även