SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Method

Определение

Предоставляет метод, который поставщики карт веб-узлов могут переопределить для проведения оптимизированного получения узлов, найденных в пределах указанного узла.Provides a method that site map providers can override to perform an optimized retrieval of nodes found in the proximity of the specified node.

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 SiteMapNode SiteMapNode

Объект SiteMapNode, действующий как опорная точка для объекта upLevel.The SiteMapNode that acts as a reference point for upLevel.

upLevel
Int32 Int32 Int32 Int32

Количество поколений предков SiteMapNode для выборки.The number of ancestor SiteMapNode generations to fetch. Значение, равное 0 показывает, что узлы-предки не получены, а -1 показывает, что все предки (и их потомки на уровне node) могут быть получены и кэшированы поставщиком.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors (and their descendant nodes to the level of node) might be retrieved and cached.

downLevel
Int32 Int32 Int32 Int32

Количество поколений узлов-потомков SiteMapNode для извлечения.The number of descendant SiteMapNode generations to fetch. Значение, равное 0 показывает, что узлы-потомки не получены, а -1 показывает, что все узлы-потомки могут быть получены и кэшированы.0 indicates no descendant nodes are retrieved and -1 indicates that all descendant nodes might be retrieved and cached.

Исключения

Значение upLevel или downLevel меньше –1.upLevel or downLevel is less than -1.

Свойство node имеет значение null.node is null.

Комментарии

Метод по HintNeighborhoodNodes умолчанию проверяет upLevel только параметры и downLevel node , которые меньше-1, и параметр, имеющий значение null.The default HintNeighborhoodNodes method only checks for an upLevel and downLevel parameters that are less than -1 and a node parameter that is null. Так как HintNeighborhoodNodes объект кэширует сведения о карте узла в памяти, метод не используется. XmlSiteMapProviderBecause the XmlSiteMapProvider object caches site map information in memory, the HintNeighborhoodNodes method is not used.

Поставщики карт веб-сайтов могут HintNeighborhoodNodes переопределить метод для выполнения оптимизированного поиска SiteMapNode объектов в близком к заданном SiteMapNode.Site map providers can override the HintNeighborhoodNodes method to perform an optimized lookup of the SiteMapNode objects in the proximity of the specified SiteMapNode. Параметр используется для указания того, сколько уровней родительского узла и узлов-предков следует прохождение от указанного SiteMapNode. upLevelThe upLevel parameter is used to specify how many levels of parent and ancestor nodes to traverse from the specified SiteMapNode. downLevel Параметр используется для указания количества уровней дочерних узлов из текущего узла для извлечения.The downLevel parameter is used to specify how many levels of child nodes from the current node to retrieve. Если рекомендуется, то узлы-предки и потомки могут быть SiteMapNode связаны с HintNeighborhoodNodes объектом, возвращаемым методом, с ParentNode помощью ChildNodes свойств и.If preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the HintNeighborhoodNodes method, using the ParentNode and ChildNodes properties.

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

Дополнительно