SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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 proveedores de mapas de sitio al recuperar un nodo antecesor para la página solicitada actualmente y capturar los nodos descendientes para el antecesor.
public:
virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode
Parámetros
- walkupLevels
- Int32
Número de niveles de nodo antecesor que se recorrerán al recuperar el nodo antecesor solicitado.
- relativeDepthFromWalkup
- Int32
Número de niveles de nodo descendientes que se van a recuperar del nodo antecesor de destino.
Devoluciones
que SiteMapNode representa un antecesor SiteMapNode de la página solicitada actualmente; de lo contrario, , nullsi no se encuentra el actual o antecesor SiteMapNode o no se puede devolver para el usuario actual.
Excepciones
walkupLevels o relativeDepthFromWalkup es menor que 0.
Comentarios
La implementación predeterminada de la SiteMapProvider clase proporciona una implementación no optimizada del GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método , llamando a los métodos y GetCurrentNodeAndHintAncestorNodes ; sin embargo, los HintNeighborhoodNodes proveedores de mapas de sitio pueden invalidar el GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método y proporcionar una implementación optimizada que usa mecanismos de almacenamiento en caché personalizados para devolver el nodo antecesor y realizar una búsqueda optimizada de los demás SiteMapNode objetos.
El walkupLevels parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores recorrer al recuperar el nodo de destino. Si existen menos niveles de los solicitados, null se devuelve. El downLevel parámetro se usa para especificar cuántos niveles de nodos descendientes del nodo antecesor de destino se van a recuperar. Si se prefiere, los nodos antecesores y descendientes se pueden vincular al SiteMapNode que devuelve el GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método , mediante las ParentNode propiedades y ChildNodes .