SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un método que los proveedores del mapa del sitio pueden reemplazar para realizar una recuperación optimizada de los nodos próximos al nodo especificado.
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)Parámetros
- node
- SiteMapNode
SiteMapNode que actúa como punto de referencia para upLevel.
- upLevel
- Int32
Número de generaciones de SiteMapNode antecesores que se van a obtener. 0 indica que no se recupera ningún nodo antecesor y -1 indica que se pueden recuperar y almacenar en memoria caché todos los antecesores (y sus nodos descendientes hasta el nivel de node).
- downLevel
- Int32
Número de generaciones de SiteMapNode descendientes que se van a obtener. 0 indica que no se recupera ningún nodo descendiente y -1 indica que se pueden recuperar y almacenar en memoria caché todos los nodos descendientes.
Excepciones
upLevel o downLevel es menor que 1.
node es null.
Comentarios
El método predeterminado HintNeighborhoodNodes solo comprueba si hay parámetros upLevel y downLevel menores que -1 y un node parámetro que es null. Dado que el objeto almacena en caché la XmlSiteMapProvider información del mapa del sitio en la memoria, no se usa el HintNeighborhoodNodes método .
Los proveedores de mapas de sitio pueden invalidar el HintNeighborhoodNodes método para realizar una búsqueda optimizada de los SiteMapNode objetos en la proximidad del especificado SiteMapNode. El upLevel parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores recorrer desde el especificado SiteMapNode. El downLevel parámetro se usa para especificar cuántos niveles de nodos secundarios del nodo actual se van a recuperar. Si se prefiere, los nodos antecesores y descendientes se pueden vincular al SiteMapNode que devuelve el HintNeighborhoodNodes método , mediante las ParentNode propiedades y ChildNodes .
