SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Metoda

  • Reference

Definice

Obor názvů:
System.Web
Sestavení:
System.Web.dll

Poskytuje optimalizovanou metodu vyhledávání pro zprostředkovatele map webů při načítání nadřazeného uzlu pro zadaný SiteMapNode objekt a načítání jeho podřízených uzlů.

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parametry

node
SiteMapNode

Slouží SiteMapNode jako referenční bod pro walkupLevels a relativeDepthFromWalkup.

walkupLevels
Int32

Počet úrovní nadřazeného uzlu, které se mají procházet při načítání požadovaného nadřazeného uzlu.

relativeDepthFromWalkup
Int32

Počet následnických úrovní uzlu, které se mají načíst z cílového nadřazeného uzlu.

Návraty

SiteMapNode

Objekt SiteMapNode , který představuje nadřazený nodeprvek ; jinak null, pokud aktuální nebo nadřazený prvek SiteMapNode nebyl nalezen nebo nelze vrátit pro aktuálního uživatele.

Výjimky

ArgumentOutOfRangeException

Hodnota zadaná pro walkupLevels nebo relativeDepthFromWalkup je menší než 0.

ArgumentNullException

node je null.

Poznámky

Výchozí implementace SiteMapProvider třídy poskytuje neoptimalizovat implementaci GetParentNodeRelativeToNodeAndHintDownFromParent metody, volání HintAncestorNodes metody a HintNeighborhoodNodes ; zprostředkovatelé mapy webu však mohou přepsat metodu GetParentNodeRelativeToNodeAndHintDownFromParent a poskytnout optimalizovanou implementaci, která používá vlastní mechanismy ukládání do mezipaměti k vrácení nadřazeného uzlu a provedení optimalizovaného vyhledávání ostatních SiteMapNode objektů. Metoda GetParentNodeRelativeToNodeAndHintDownFromParent je velmi podobná GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metodě .

Parametr walkupLevels slouží k určení, kolik úrovní nadřazených a nadřazených uzlů se má procházet při načítání cílového uzlu. Pokud existuje méně úrovní, než je požadováno, null vrátí se hodnota . Parametr downLevel slouží k určení, kolik úrovní následnických uzlů z cílového nadřazeného uzlu se má načíst. Pokud je to preferované, nadřazené a odvozené uzly lze propojit s objektem SiteMapNode vráceným metodou GetParentNodeRelativeToNodeAndHintDownFromParent pomocí ParentNode vlastností a ChildNodes . Pokud existuje méně úrovní nadřazených uzlů, než určuje upLevel parametr , null vrátí se . Je na implementátorovi zprostředkovatele, aby se rozhodl, jak se vypořádat se situací, kdy je počet dostupných úrovní následných uzlů menší než hodnota určená parametrem downLevel .

Platí pro

Viz také