SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 methode die siteoverzichtproviders kunnen overschrijven om een geoptimaliseerde ophaalbewerking uit te voeren van een of meer niveaus van bovenliggende en bovenliggende knooppunten ten opzichte van het opgegeven SiteMapNode object.
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)
Parameters
- node
- SiteMapNode
De SiteMapNode die fungeert als referentiepunt voor upLevel.
- upLevel
- Int32
Het aantal bovenliggende SiteMapNode generaties dat moet worden opgehaald. 0 geeft aan dat er geen bovenliggende knooppunten worden opgehaald en -1 geeft aan dat alle voorouders mogelijk worden opgehaald en in de cache worden opgeslagen.
Uitzonderingen
upLevel is kleiner dan -1.
node is null.
Opmerkingen
De standaardmethode HintAncestorNodes controleert alleen op een upLevel parameter die kleiner is dan -1 en een node parameter die is null. Omdat siteoverzichtgegevens in het geheugen in de cache worden opgeslagen in de XmlSiteMapProvider klasse, wordt de HintAncestorNodes methode niet gebruikt.
Siteoverzichtproviders kunnen de HintAncestorNodes methode overschrijven om een geoptimaliseerde ophaalbewerking van bovenliggende en bovenliggende knooppunten van het opgegeven SiteMapNode object uit te voeren.
De upLevel parameter wordt gebruikt om op te geven hoeveel niveaus van bovenliggende en bovenliggende knooppunten moeten worden doorkruist van de opgegeven SiteMapNode. Als er minder niveaus bestaan dan aangevraagd, worden alle beschikbare bovenliggende knooppunten geretourneerd binnen de opgegeven afhankelijkheid. Indien gewenst kan het bovenliggende knooppunt worden gekoppeld aan de opgegeven SiteMapNode met behulp van de ParentNode eigenschap.