Compartir a través de


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

[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 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 roles a la colección de proveedores de administración de roles.

clear

Elemento opcional.

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

remove

Elemento opcional.

Quita de la colección de proveedores de administración de roles 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 roles.

Comentarios

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

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 roles: 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 roles.

<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 la configuración

Providers

Ubicaciones configurables

Machine.config

Web.config del 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

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

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

Understanding ASP.NET Role Management

Securing Configuration

Configuration Inheritance

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Referencia de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API