SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 uno o más niveles de nodos primarios y antecesores, de manera relativa al objeto SiteMapNode especificado.
public:
virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel 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.
Excepciones
upLevel es menor que 1.
node es null.
Comentarios
El método predeterminado HintAncestorNodes solo comprueba si hay un upLevel parámetro menor que -1 y un node parámetro que es null. Dado que la clase almacena en caché la XmlSiteMapProvider información de mapa del sitio en la memoria, no se usa el HintAncestorNodes método .
Los proveedores de mapas de sitio pueden invalidar el HintAncestorNodes método para realizar una recuperación optimizada de nodos primarios y antecesores del objeto especificado SiteMapNode .
El upLevel parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores recorrer desde el especificado SiteMapNode. Si existen menos niveles de los solicitados, se devuelven todos los nodos antecesores disponibles dentro del límite especificado. Si se prefiere, el nodo primario se puede vincular al especificado SiteMapNode mediante la ParentNode propiedad .