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 свойства.
