SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Метод

Определение

Предоставляет оптимизированный метод просмотра для поставщиков карт веб-узлов во время получения узла-предка для запрашиваемой в настоящее время страницы и извлекает узлы-потомки для узла-предка.

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

Параметры

walkupLevels
Int32

Количество уровней узлов-предков для прохождения во время получения запрошенного узла-предка.

relativeDepthFromWalkup
Int32

Количество уровней узлов-потомков для получения из целевого узла-предка.

Возвращаемое значение

Объект SiteMapNode, представляющий узел-предок SiteMapNode запрашиваемой в данный момент страницы; в противном случае — значение null, если текущий узел или узел-предок SiteMapNode не найден или не может быть возвращен для текущего пользователя.

Исключения

Значение параметра walkupLevels или relativeDepthFromWalkup меньше 0.

Комментарии

Реализация SiteMapProvider класса по умолчанию предоставляет неоптимированную реализацию GetParentNodeRelativeToCurrentNodeAndHintDownFromParent метода , вызывая GetCurrentNodeAndHintAncestorNodes методы и HintNeighborhoodNodes . Однако поставщики карт сайта могут переопределить GetParentNodeRelativeToCurrentNodeAndHintDownFromParent метод и предоставить оптимизированную реализацию, которая использует пользовательские механизмы кэширования для возврата узла-предка и выполнения оптимизированного поиска других SiteMapNode объектов.

Параметр walkupLevels используется для указания количества уровней родительского и родительского узлов, которые необходимо пройти при извлечении целевого узла. Если существует меньше уровней, чем запрошено, null возвращается значение . Параметр downLevel используется для указания количества уровней узлов-потомков из целевого узла-предка для извлечения. При желании узлы-предки и потомки можно связать с SiteMapNode , возвращаемым методом GetParentNodeRelativeToCurrentNodeAndHintDownFromParent , с помощью ParentNode свойств и ChildNodes .

Применяется к

См. также раздел