SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Метод

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

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

public:
 virtual void HintNeighborhoodNodes(System::Web::SiteMapNode ^ node, int upLevel, int downLevel);

public virtual void HintNeighborhoodNodes (System.Web.SiteMapNode node, int upLevel, int downLevel);

abstract member HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
override this.HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit

Public Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel As Integer)

Параметры

node

SiteMapNode

Объект SiteMapNode, действующий как опорная точка для объекта upLevel.

upLevel

Int32

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

downLevel

Int32

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

Исключения

ArgumentOutOfRangeException

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

ArgumentNullException

node имеет значение null.

Комментарии

Метод по умолчанию HintNeighborhoodNodes проверяет upLevel только параметры и downLevel , которые меньше -1, и node параметр , который имеет значение null. XmlSiteMapProvider Так как объект кэширует сведения о карте сайта в памяти, HintNeighborhoodNodes метод не используется.

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

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

• HintAncestorNodes(SiteMapNode, Int32)