Språk

SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Metod

Definition

Tillhandahåller en optimerad uppslagsmetod för webbplatsöversiktsproviders när du hämtar noden för den aktuella sidan och hämtar de överordnade och överordnade platsmappningsnoderna för den aktuella sidan.

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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

Parametrar

upLevel
Int32

Antalet överordnade webbplatsmappningsnodgenerationer som ska hämtas. Värdet -1 anger att alla överordnade kan hämtas och cachelagras av providern.

Returer

En SiteMapNode som representerar den begärda sidan, annars , nullom den SiteMapNode inte hittas eller inte kan returneras för den aktuella användaren.

Undantag

upLevel är mindre än -1.

Kommentarer

Standardimplementeringen av GetCurrentNodeAndHintAncestorNodes metoden returnerar CurrentNode egenskapen. Webbplatsöversiktsprovidrar kan dock åsidosätta GetCurrentNodeAndHintAncestorNodes metoden och tillhandahålla en optimerad implementering som använder anpassade cachelagringsmekanismer för att returnera den aktuella SiteMapNode, samt överordnade och överordnade noder för den överordnade.

Parametern upLevel används för att ange hur många nivåer av överordnade och överordnade noder som ska hämtas. Om så önskas kan de överordnade noderna och överordnade noderna länkas till det SiteMapNode objekt som returneras av metoden med hjälp GetCurrentNodeAndHintAncestorNodes av ParentNode egenskapen .

Klassen XmlSiteMapProvider, som är standardprovidern för ASP.NET, cachelagrar hela webbplatskartan i minnet, vilket resulterar i lite eller inga omkostnader när du frågar XmlSiteMapProvider för specifika SiteMapNode objekt.

Gäller för

Se även