SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет метод, который поставщики карт веб-узлов могут переопределить для проведения оптимизированного получения узлов, найденных в пределах указанного узла.
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 -> unitPublic 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 показывает, что все узлы-потомки могут быть получены и кэшированы.
Исключения
Значение upLevel или downLevel меньше –1.
node имеет значение null.
Комментарии
Метод по умолчанию HintNeighborhoodNodes проверяет upLevel только параметры и downLevel , которые меньше -1, и node параметр , который имеет значение null.
XmlSiteMapProvider Так как объект кэширует сведения о карте сайта в памяти, HintNeighborhoodNodes метод не используется.
Поставщики карт сайта могут переопределить HintNeighborhoodNodes метод для выполнения оптимизированного SiteMapNode поиска объектов, которые находятся рядом с указанным SiteMapNodeобъектом . Параметр upLevel используется, чтобы указать, сколько уровней родительских и родительских узлов необходимо пройти из указанного SiteMapNode. Параметр downLevel используется, чтобы указать, сколько уровней дочерних узлов из текущего узла требуется извлечь. При желании узлы-предки и потомки можно связать с SiteMapNode , возвращаемым методом HintNeighborhoodNodes , с помощью ParentNode свойств и ChildNodes .
