SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een geoptimaliseerde opzoekmethode voor siteoverzichtproviders bij het ophalen van het knooppunt voor de momenteel aangevraagde pagina en het ophalen van de bovenliggende en bovenliggende siteoverzichtknooppunten voor de huidige pagina.
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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParameters
- upLevel
- Int32
Het aantal bovenliggende siteoverzichtsknooppuntgeneraties dat moet worden opgehaald. Een waarde van -1 geeft aan dat alle voorouders kunnen worden opgehaald en in de cache worden opgeslagen door de provider.
Retouren
Een SiteMapNode die de momenteel aangevraagde pagina vertegenwoordigt, anders, nullals de SiteMapNode pagina niet wordt gevonden of niet kan worden geretourneerd voor de huidige gebruiker.
Uitzonderingen
upLevel is kleiner dan -1.
Opmerkingen
De standaard implementatie van de methode retourneert de GetCurrentNodeAndHintAncestorNodesCurrentNode eigenschap. Siteoverzichtproviders kunnen de GetCurrentNodeAndHintAncestorNodes methode echter overschrijven en een geoptimaliseerde implementatie bieden die gebruikmaakt van aangepaste cachingmechanismen om de huidige SiteMapNode, evenals de bovenliggende en bovenliggende knooppunten van het bovenliggende item te retourneren.
De upLevel parameter wordt gebruikt om op te geven hoeveel niveaus bovenliggende en bovenliggende knooppunten moeten worden opgehaald. Indien gewenst kunnen de bovenliggende en bovenliggende knooppunten worden gekoppeld aan het SiteMapNode object dat door de GetCurrentNodeAndHintAncestorNodes methode wordt geretourneerd, met behulp van de ParentNode eigenschap.
De XmlSiteMapProvider-klasse, de standaardsiteoverzichtprovider voor ASP.NET, slaat het hele siteoverzicht in het geheugen op, wat resulteert in weinig of geen overhead bij het uitvoeren van query's op de XmlSiteMapProvider voor specifieke SiteMapNode-objecten.
