Compartir a través de

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

  • Artículo

Actualización: noviembre 2007

Agrega un proveedor a la colección de proveedores de exploración.

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

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento siteMap (Esquema de configuración de ASP.NET)
      Elemento providers para siteMap (Esquema de configuración de ASP.NET)
        Elemento add aplicado a providers para siteMap (Esquema de configuración de ASP.NET)

<add  
   name="provider name" 
   type="provider type"
   description="description"
   siteMapFile="path"
/>

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

description

Atributo String requerido.

Describe el proveedor del mapa del sitio.

name

Atributo String requerido.

Especifica el nombre del proveedor que se va a agregar.

siteMapFile

Atributo String opcional.

Especifica el archivo que contiene los datos del mapa del sitio. La referencia a siteMapFile puede ser:

  • Una referencia de ruta de acceso relativa a la aplicación (por ejemplo, ~/SiteMapFile1.sitemap).

  • Una ruta de acceso virtual asignada a una ubicación que esté dentro de la estructura de directorios de la aplicación (por ejemplo, /directory1/directory2/SiteMapFile1.sitemap).

  • Una referencia de ruta de acceso relativa a la raíz de la estructura de directorios de la aplicación (por ejemplo, SiteMapFile1.sitemap).

type

Atributo String requerido.

Especifica un tipo que implementa la clase ProviderBase.

El valor type debe ser una referencia de ensamblado completa.

securityTrimmingEnabled

El valor predeterminado es false.

Si es true y si el proveedor incluye la lógica necesaria, el proveedor del mapa del sitio realiza una comprobación de la función utilizando los nodos recuperados. El proveedor también realiza una comprobación de la función con respecto al usuario actual. Se aplican las reglas de autorización de direcciones URL de la aplicación y, si se utiliza la autenticación de Microsoft Windows, también se aplican las reglas de autorización de la aplicación.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Proporciona el elemento raíz de cada archivo de configuración utilizado por 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.

siteMap

Define opciones de configuración para admitir la infraestructura de configuración, almacenamiento y representación de la exploración de sitios.

providers

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

Comentarios

Configuración predeterminada

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

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

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>
      <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

SiteMapSection.Providers

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos

Servicios de Microsoft Internet Information Server (IIS) 5.0, 5.1 ó 6.0

.NET Framework 2.0

Microsoft Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la configuración de ASP.NET

Controles de servidor Web ASP.NET y funciones del explorador

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

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

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

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

Elemento <configuration>

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

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

System.Configuration

System.Web.Configuration

Otros recursos

Archivos de configuración de ASP.NET

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

API de configuración de ASP.NET