SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Метод

  • Ссылка

Определение

Пространство имен:
System.Web
Сборка:
System.Web.dll

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

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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Параметры

upLevel
Int32

Количество поколений предков SiteMapNode для выборки. Значение, равное 0 показывает, что узлы-предки не получены, а -1 показывает, что все предки могут быть получены и кэшированы поставщиком.

downLevel
Int32

Количество поколений дочерних элементов SiteMapNode для извлечения. Значение, равное 0 показывает, что узлы-потомки не получены, а -1 показывает, что все узлы-потомки могут быть получены и кэшированы поставщиком.

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

SiteMapNode

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

Исключения

ArgumentOutOfRangeException

Значение upLevel или downLevel меньше –1.

Комментарии

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

Параметр upLevel используется для указания количества уровней родительского и родительского узлов, которые необходимо извлечь и кэшировать, а также их непосредственных дочерних узлов. Параметр downLevel используется для указания количества уровней узлов-потомков из текущего SiteMapNode извлекаемого. При желании узлы-предки и потомки могут быть связаны с SiteMapNode , возвращаемым элементом

GetCurrentNodeAndHintNeighborhoodNodes метод с использованием ParentNode свойств и ChildNodes . Если уровней предков или дочерних узлов меньше, чем указано в upLevel или downLevel, извлекаются только доступные уровни.

Класс XmlSiteMapProvider , который является поставщиком карты сайта по умолчанию для ASP.NET, кэширует всю карту сайта в памяти, что приводит к небольшим затратам или не к затратам при запросе XmlSiteMapProvider для конкретных SiteMapNode объектов.

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

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