Compartir a través de

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

Actualización: noviembre 2007

Define una colección de proveedores de funciones para la administración de funciones.

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento roleManager (Esquema de configuración de ASP.NET)
      Elemento providers para roleManager (Esquema de configuración de ASP.NET)

<providers>
   <add />
   <clear/>
   <remove />
</providers>

Atributos y elementos

Las secciones siguientes describen los atributos, los elementos secundarios y los elementos primarios de esta sección.

Atributos

Ninguno.

Elementos secundarios

Elemento

Descripción

add

Elemento opcional.

Agrega una instancia de proveedor de funciones a la colección de proveedores de administración de funciones.

clear

Elemento opcional.

Quita todas las referencias a proveedores de administración de funciones heredados, permitiendo sólo las que agrega el elemento add actual.

remove

Elemento opcional.

Quita una referencia a un proveedor heredado de la colección de proveedores de administración de funciones.

Elementos primarios

Elemento

Descripción

configuration

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

system.web

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

roleManager

Configura una aplicación para la administración de funciones.

Comentarios

El elemento providers define una colección de proveedores de funciones para la administración de funciones.

Para obtener información sobre cómo obtener acceso y modificar los valores de configuración del elemento roleManager en el código de la aplicación, vea la información relativa a la clase RoleManagerSection, así como a los siguientes proveedores de funciones: WindowsTokenRoleProvider, SqlRoleProvider.

Configuración predeterminada

El elemento element predeterminado siguiente se configura en el archivo de configuración del equipo.

<roleManager>
   <providers>
      <add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
   </providers>
</roleManager>

Ejemplo

En el ejemplo siguiente, se muestra una aplicación de ASP.NET configurada de manera que utilice la clase SqlRoleProvider para almacenar y recuperar la información de funciones.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
          <add
            name="SqlProvider"
            type="System.Web.Security.SqlRoleProvider"
            connectionStringName="SqlServices" 
            applicationName="SampleApplication" />
            
        </providers>
      </roleManager>
  </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

RoleManagerSection

Miembro de la configuración

Providers

Ubicaciones configurables

Machine.config

Web.config del nivel de raíz

Web.config del nivel de aplicaciones

Requisitos   

IIS 5.0, IIS 5.1 o IIS 6.0

.NET Framework 2.0

Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Configurar directorios concretos mediante la configuración de la ubicación

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

Conceptos

Descripción de la administración de funciones

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

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

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

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

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

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

Elemento configuration (Esquema de configuración general)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Referencia de ASP.NET

Administrar sitios web ASP.NET

API de configuración de ASP.NET