SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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

Public 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

ArgumentOutOfRangeException

upLevel o downLevel es menor que 1.

ArgumentNullException

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 .

Consulte también

• HintAncestorNodes(SiteMapNode, Int32)