SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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 een bovenliggend knooppunt voor de momenteel aangevraagde pagina en het ophalen van de onderliggende knooppunten voor de bovenliggende knooppunten.
public:
virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode
Parameters
- walkupLevels
- Int32
Het aantal bovenliggende knooppuntniveaus dat moet worden doorlopen bij het ophalen van het aangevraagde bovenliggende knooppunt.
- relativeDepthFromWalkup
- Int32
Het aantal onderliggende knooppuntniveaus dat moet worden opgehaald uit het doelvoorliggende knooppunt.
Retouren
Een SiteMapNode die een voorouder van de momenteel aangevraagde pagina vertegenwoordigt, anders, SiteMapNodeals de huidige of bovenliggende null pagina SiteMapNode niet wordt gevonden of niet kan worden geretourneerd voor de huidige gebruiker.
Uitzonderingen
walkupLevels of relativeDepthFromWalkup kleiner is dan 0.
Opmerkingen
De standaard implementatie van de SiteMapProvider klasse biedt een niet-geoptimaliseerde implementatie van de GetParentNodeRelativeToCurrentNodeAndHintDownFromParent methode, het aanroepen van de GetCurrentNodeAndHintAncestorNodes en HintNeighborhoodNodes methoden. Siteoverzichtproviders kunnen de GetParentNodeRelativeToCurrentNodeAndHintDownFromParent methode echter overschrijven en een geoptimaliseerde implementatie bieden die gebruikmaakt van aangepaste cachingmechanismen om het bovenliggende knooppunt te retourneren en een geoptimaliseerde lookup van de andere SiteMapNode objecten uit te voeren.
De walkupLevels parameter wordt gebruikt om op te geven hoeveel niveaus van bovenliggende en bovenliggende knooppunten moeten worden doorlopen bij het ophalen van het doelknooppunt. Als er minder niveaus bestaan dan aangevraagd, null wordt deze geretourneerd. De downLevel parameter wordt gebruikt om op te geven hoeveel niveaus van onderliggende knooppunten van het doelvoorliggende knooppunt moeten worden opgehaald. Indien gewenst kunnen de bovenliggende en onderliggende knooppunten worden gekoppeld aan de SiteMapNode knooppunten die door de GetParentNodeRelativeToCurrentNodeAndHintDownFromParent methode worden geretourneerd, met behulp van de ParentNode en ChildNodes eigenschappen.