SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(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 de búsqueda optimizado para los proveedores del mapa del sitio en las operaciones de recuperación de un nodo para hallar la página solicitada actualmente y de extracción de los nodos del mapa del sitio próximos al nodo actual.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNodeParámetros
- upLevel
- Int32
Número de generaciones de SiteMapNode antecesores que se van a obtener. 0 indica que no se recuperará ningún nodo antecesor y -1 indica que el proveedor puede recuperar y almacenar en memoria caché todos los antecesores.
- downLevel
- Int32
Número de generaciones secundarias de SiteMapNode que se van a extraer. 0 indica que no se recuperará ningún nodo descendiente y -1 indica que el proveedor puede recuperar y almacenar en memoria caché todos los descendientes.
Devoluciones
Es un SiteMapNode que representa la página solicitada actualmente; de lo contrario, es null si SiteMapNode no se encuentra o no se puede devolver para el usuario actual.
Excepciones
upLevel o downLevel es menor que 1.
Comentarios
La implementación predeterminada del GetCurrentNodeAndHintNeighborhoodNodes método devuelve la CurrentNode propiedad ; sin embargo, los proveedores de mapas de sitio pueden invalidar el GetCurrentNodeAndHintNeighborhoodNodes método y proporcionar una implementación optimizada que usa mecanismos de almacenamiento en caché personalizados para devolver el objeto actual SiteMapNode , así como SiteMapNode los objetos que están en la proximidad del actual SiteMapNode.
El upLevel parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores se van a recuperar y almacenar en caché, junto con sus elementos secundarios inmediatos. El downLevel parámetro se usa para especificar cuántos niveles de nodos descendientes del actual SiteMapNode se van a recuperar. Si se prefiere, los nodos antecesores y descendientes se pueden vincular al SiteMapNode que devuelve .
GetCurrentNodeAndHintNeighborhoodNodes método , mediante las ParentNode propiedades y ChildNodes . Si hay menos niveles de nodo antecesores o secundarios que los especificados por upLevel o downLevel, solo se recuperan los que están disponibles.
La XmlSiteMapProvider clase , que es el proveedor de mapa de sitio predeterminado para ASP.NET, almacena en caché todo el mapa del sitio en la memoria, lo que da lugar a poca o ninguna sobrecarga al consultar los XmlSiteMapProvider objetos específicos SiteMapNode .
