SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Метод

  • Ссылка

Определение

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

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

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Параметры

node
SiteMapNode

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

walkupLevels
Int32

Количество уровней узлов-предков для прохождения во время получения запрошенного узла-предка.

relativeDepthFromWalkup
Int32

Количество уровней узлов-потомков для получения из целевого узла-предка.

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

SiteMapNode

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

Исключения

ArgumentOutOfRangeException

Заданное значение для walkupLevels или relativeDepthFromWalkup меньше 0.

ArgumentNullException

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

Комментарии

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

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

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

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