SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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 mapy webu při načítání nadřazeného uzlu pro aktuálně požadovanou stránku a načítání následnických uzlů pro nadřazenou položku.
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
Parametry
- walkupLevels
- Int32
Počet úrovní nadřazených uzlů, které se mají procházet při načítání požadovaného nadřazeného uzlu.
- relativeDepthFromWalkup
- Int32
Počet úrovní podřízených uzlů, které se mají načíst z cílového nadřazeného uzlu.
Návraty
A SiteMapNode , který představuje nadřazenou položku SiteMapNode aktuálně požadované stránky; v opačném případě , null
pokud aktuální nebo nadřazený objekt SiteMapNode není nalezen nebo nelze vrátit aktuálního uživatele.
Výjimky
walkupLevels
nebo relativeDepthFromWalkup
je menší než 0.
Poznámky
Výchozí implementace SiteMapProvider třídy poskytuje neoptimalizační implementaci GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metody, volání GetCurrentNodeAndHintAncestorNodes metod a HintNeighborhoodNodes . Zprostředkovatelé mapy webu však mohou přepsat metodu GetParentNodeRelativeToCurrentNodeAndHintDownFromParent a poskytnout optimalizovanou implementaci, která používá vlastní mechanismy ukládání do mezipaměti k vrácení nadřazeného uzlu a provádění optimalizovaného vyhledávání ostatních SiteMapNode objektů.
Parametr walkupLevels
slouží k určení počtu úrovní nadřazených a nadřazených uzlů, které se mají 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. Parametr downLevel
slouží k určení, kolik úrovní následnických uzlů z cílového nadřazeného uzlu se má načíst. V případě potřeby lze nadřazené a následné uzly propojit s SiteMapNode uzlem, který je vrácen metodou GetParentNodeRelativeToCurrentNodeAndHintDownFromParent , pomocí ParentNode vlastností a ChildNodes .