SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет оптимизированный метод просмотра для поставщиков карт веб-узлов во время получения узла-предка для указанного объекта SiteMapNode и извлечения его дочерних узлов.
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 SiteMapNodeПараметры
- node
- SiteMapNode
Объект SiteMapNode, действующий в качестве опорной точки для объектов walkupLevels и relativeDepthFromWalkup.
- walkupLevels
- Int32
Количество уровней узлов-предков для прохождения во время получения запрошенного узла-предка.
- relativeDepthFromWalkup
- Int32
Количество уровней узлов-потомков для получения из целевого узла-предка.
Возвращаемое значение
Объект SiteMapNode, представляющий узел-предок node; в противном случае — значение null, если текущий узел или узел-предок SiteMapNode не найден или не может быть возвращен для текущего пользователя.
Исключения
Заданное значение для walkupLevels или relativeDepthFromWalkup меньше 0.
node имеет значение null.
Комментарии
Реализация SiteMapProvider класса по умолчанию предоставляет неоптимированную реализацию GetParentNodeRelativeToNodeAndHintDownFromParent метода , вызывая HintAncestorNodes методы и HintNeighborhoodNodes . Однако поставщики карт сайта могут переопределить GetParentNodeRelativeToNodeAndHintDownFromParent метод и предоставить оптимизированную реализацию, которая использует пользовательские механизмы кэширования для возврата узла-предка и выполнения оптимизированного поиска других SiteMapNode объектов. Метод GetParentNodeRelativeToNodeAndHintDownFromParent очень похож на GetParentNodeRelativeToCurrentNodeAndHintDownFromParent метод .
Параметр walkupLevels используется для указания количества уровней родительского и родительского узлов, которые необходимо пройти при извлечении целевого узла. Если существует меньше уровней, чем запрошено, null возвращается значение . Параметр downLevel используется для указания количества уровней узлов-потомков из целевого узла-предка для извлечения. При желании узлы-предки и потомки можно связать с SiteMapNode , возвращаемым методом GetParentNodeRelativeToNodeAndHintDownFromParent , с помощью ParentNode свойств и ChildNodes . Если уровней узла-предка меньше, чем указано параметром upLevel , null возвращается . Разработчик поставщика должен решить, как обрабатывать ситуацию, когда количество доступных уровней узлов-потомков меньше значения, указанного параметром downLevel .
