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