SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(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 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.