Elemento siteMap (Esquema de configuración de ASP.NET)

  • Artículo

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Define opciones de configuración para admitir la infraestructura de configuración, almacenamiento y representación de la navegación del sitio.

Se trata de un elemento nuevo en .NET Framework, versión 2.0.

<siteMap
  defaultProvider="provider name">
  <providers>...</providers> 
</siteMap>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

defaultProvider

Atributo necesario.

Especifica el nombre del proveedor.

El valor predeterminado es el proveedor XmlSiteMapProvider.

Elementos secundarios

Elemento

Descripción

providers

Define una colección de proveedores de navegación.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

Comentarios

Configuración predeterminada

El siguiente elemento siteMap predeterminado se configura en el archivo Web.config raíz en la versión 2.0 de .NET Framework.

<siteMap>
     <providers>
           <add siteMapFile="web.sitemap" name="AspNetXmlSiteMapProvider"
                type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.0.0, Culture=neutral, 
                PublicKeyToken=b03f5f7f11d50a3a" />
     </providers>
</siteMap>

Ejemplo

En el ejemplo de código siguiente se muestra cómo agregar un proveedor del mapa del sitio al archivo Web.config para reemplazar el predeterminado definido para ASP.NET.

<configuration>
  <system.web>
    <siteMap defaultProvider="XmlSiteMapReader">
      <providers>
        <add 
          name=" XmlSiteMapReader"
          type="XmlSiteMapProvider, System.Web, Version=1.1.3300.0,
                Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
          siteMapFile="my.sitemap" 
          description="XmlSiteMapProvider that loads my.sitemap"/>
      </providers>
    </siteMap>
  </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.SiteMapSection

Miembro de configuración

SystemWebSectionGroup.SiteMap

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0

.NET Framework versión 2.0

Microsoft Visual Studio 2005

Vea también

Tareas

How to: Lock ASP.NET Configuration Settings

Referencia

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento <configuration>

Elemento providers para siteMap (Esquema de configuración de ASP.NET)

System.Configuration

System.Web.Configuration

Conceptos

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Otros recursos

ASP.NET Configuration Files

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

ASP.NET Configuration API