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