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

Define una colección de proveedores de rol para la administración de roles.

<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 de la colección de proveedores de administración de funciones una referencia a un proveedor heredado.

Elementos primarios

Elemento

Descripción

configuration

Es el elemento raíz necesario en cada archivo de configuración que se utiliza en Common Language Runtime y las aplicaciones de .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 secciones de configuración

RoleManagerSection

Miembro de configuración

Providers

Ubicaciones configurables

Machine.config

Web.config en el nivel raíz

Web.config de nivel de aplicación

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

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

Conceptos

Descripción de la administración de roles

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Referencia de ASP.NET

Administración de sitios web ASP.NET

API de configuración de ASP.NET