SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет оптимизированный метод просмотра для поставщиков карт веб-узлов во время получения узла для запрашиваемой в настоящее время страницы и извлекает родительские узлы и узлы-предки карт веб-узлов для текущей страницы.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeПараметры
- upLevel
- Int32
Полученное число поколений узлов-предков карты веб-узла. Значение -1 показывает, что все предки могут быть получены и кэшированы поставщиком.
Возвращаемое значение
Объект SiteMapNode, представляющий запрашиваемую в данный момент страницу; в противном случае — значение null, если объект SiteMapNode не найден или не может быть возвращен для текущего пользователя.
Исключения
Значение upLevel меньше -1.
Комментарии
Реализация GetCurrentNodeAndHintAncestorNodes метода по умолчанию возвращает CurrentNode свойство. Однако поставщики карт сайта могут переопределить GetCurrentNodeAndHintAncestorNodes метод и предоставить оптимизированную реализацию, которая использует пользовательские механизмы кэширования для возврата текущего SiteMapNode, а также родительских и родительских узлов родительского узла.
Параметр upLevel используется для указания количества уровней извлекаемых родительских и предковых узлов. При желании родительские и предки узлы могут быть связаны с SiteMapNode объектом, возвращаемым методом GetCurrentNodeAndHintAncestorNodes , с помощью ParentNode свойства.
КлассXmlSiteMapProvider, который является поставщиком карты сайта по умолчанию для ASP.NET, кэширует всю карту сайта в памяти, что приводит к незначительным затратам при запросе XmlSiteMapProvider определенных SiteMapNode объектов.