SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

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

SiteMapNode

A SiteMapNode , který představuje nadřazenou položku SiteMapNode aktuálně požadované stránky; v opačném případě , nullpokud aktuální nebo nadřazený objekt SiteMapNode není nalezen nebo nelze vrátit aktuálního uživatele.

Výjimky

ArgumentOutOfRangeException

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 .

Viz také

• GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)