Compartir a través de

Elemento add aplicado a providers para 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].

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

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

<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

El atributo String es obligatorio.

Describe el proveedor del mapa del sitio.

name

El atributo String es obligatorio.

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

El atributo String es obligatorio.

Especifica un tipo que implementa la clase ProviderBase.

El valor type debe ser una referencia calificada con el nombre de ensamblado.

securityTrimmingEnabled

Tiene como valor predeterminado false.

Si es true y si el proveedor incluye la lógica necesaria, el proveedor del mapa del sitio realiza una comprobación del rol utilizando los nodos recuperados. El proveedor también realiza una comprobación del rol 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 navegación del sitio.

providers

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

Comentarios

Configuración predeterminada

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

<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

Microsoft Internet Information Services (IIS) 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 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

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