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

Quita todas las referencias a proveedores de funciones heredados y permite sólo los proveedores de funciones agregados por el elemento add actual.

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

<clear/>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz necesario de cada archivo de configuración que utilizan 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.
roleManager	Configura una aplicación para la administración de funciones.
providers	Define una colección de proveedores de función para la administración de funciones.

Comentarios

El elemento clear quita todas las referencias a proveedores de administración de funciones heredados almacenados en el elemento providers, y permite sólo los proveedores de administración de funciones agregados por los elementos add subsiguientes.

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 a los valores de configuración del elemento roleManager en el código de una aplicación, o sobre cómo modificarlos, vea RoleManagerSection.

Ejemplo

En el siguiente ejemplo de código se muestra cómo configurar una aplicación ASP.NET de manera que utilice el proveedor SqlRoleProvider para almacenar y recuperar información de funciones. El elemento <clear> borra la colección RoleProviderCollection antes de agregar el SqlRoleProvider.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
        <clear />
          <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 configuración	Providers
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones
Requisitos	Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 2.0 Microsoft 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 providers para roleManager (Esquema de configuración de ASP.NET)

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