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.SiteMapNodePublic 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 .
