StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 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í.
Agrega SiteMapNode a las colecciones mantenidas por el proveedor del mapa del sitio y establece una relación de elemento primario/secundario entre los objetos SiteMapNode.
protected public:
override void AddNode(System::Web::SiteMapNode ^ node, System::Web::SiteMapNode ^ parentNode);protected internal override void AddNode (System.Web.SiteMapNode node, System.Web.SiteMapNode parentNode);override this.AddNode : System.Web.SiteMapNode * System.Web.SiteMapNode -> unitProtected Friend Overrides Sub AddNode (node As SiteMapNode, parentNode As SiteMapNode)Parámetros
- node
- SiteMapNode
SiteMapNode que se agrega al proveedor del mapa del sitio.
- parentNode
- SiteMapNode
SiteMapNode bajo el que se agregará node.
Excepciones
node es null.
Url o Key ya está registrado en el StaticSiteMapProvider. Un nodo del mapa del sitio debe estar compuesto por páginas con direcciones URL o claves únicas.
Comentarios
El nodo de mapa de sitio identificado por el node parámetro se agrega a una colección interna y se crea una relación de elementos primarios y secundarios entre él y el nodo de mapa de sitio identificado por el parentNode parámetro .
La dirección URL de un nodo de mapa de sitio puede interpretarse cuando se agrega a las colecciones internas. Las direcciones URL relativas y relativas de la aplicación se expanden a las rutas de acceso virtuales absolutas de la aplicación, que se usan internamente para almacenar y acceder a las instancias individuales de la SiteMapNode clase. No se interpretan otras direcciones URL, como rutas de acceso físicas, rutas de acceso con protocolos y rutas unc.
La XmlSiteMapProvider clase , que se deriva de la StaticSiteMapProvider clase y es el proveedor de mapa de sitio predeterminado para ASP.NET, usa la Url propiedad de un SiteMapNode objeto como clave de búsqueda en sus colecciones internas de forma predeterminada. Si se establece la Url propiedad de SiteMapNode , debe ser única dentro del ámbito del proveedor de mapa del sitio. El FindSiteMapNode método intenta recuperar nodos de mapa de sitio en función de su Url propiedad . De lo contrario, puede usar la Key propiedad y el método correspondiente FindSiteMapNodeFromKey para recuperar los nodos de mapa del sitio. Si no se especifica o UrlKey , el proveedor de mapas del sitio genera automáticamente un Key para realizar un seguimiento de los nodos del mapa del sitio.
Notas a los desarrolladores de herederos
Al invalidar el AddNode(SiteMapNode, SiteMapNode) método , asegúrese de que la Key propiedad se establece en un valor único al agregar el nodo de mapa del sitio mediante el AddNode método .
