SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParametry
- 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
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
Hodnota zadaná pro walkupLevels nebo relativeDepthFromWalkup je menší než 0.
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 .
