SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Methode

Definitie

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.

Van toepassing op

Zie ook