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

Artículo
08/10/2011

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

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

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

Atributos y elementos

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

Atributos

Atributo	Descripción
applicationName	Atributo String opcional. Especifica el nombre de la aplicación en la que se almacenan los nombres de función en el origen de datos. El nombre de aplicación permite que varias aplicaciones ASP.NET usen la misma base de datos sin que se encuentren nombres de función duplicados para aplicaciones diferentes. Por otra parte, varias aplicaciones ASP.NET pueden utilizar la misma información de función si especifican el mismo nombre de aplicación. Los proveedores de funciones que están incluidos con .NET Framework usan el valor de ApplicationVirtualPath para la propiedad ApplicationName si no se especifica este atributo.
cacheRefreshInterval	Atributo Int32 opcional. Especifica el número de minutos que transcurren entre las actualizaciones impuestas de los datos del almacén de directivas almacenados en caché y se aplica únicamente a AuthorizationStoreRoleProvider. El valor predeterminado es 60.
commandTimeout	Atributo Int32 opcional. Especifica los segundos que deben transcurrir para que se agote el tiempo de espera de un comando emitido al origen de datos del Administrador de funciones. El proveedor de SQL utiliza este tiempo de espera al crear objetos SqlCommand. De manera predeterminada, este atributo no se establece en la configuración de ASP.NET. Como resultado se utiliza el valor predeterminado de ADO.NET de 30 segundos. Si se establece este atributo, el proveedor SQL utiliza el valor de tiempo de espera configurado para todos los comandos SQL emitidos a la base de datos. El valor predeterminado es 30 (valor predeterminado de ADO.NET).
connectionStringName	Atributo String requerido. Especifica el nombre de una cadena de conexión definida en el elemento <connectionStrings>. El proveedor que se agrega utilizará la cadena de conexión especificada.
description	Atributo String opcional. Especifica la descripción de la instancia del proveedor de funciones.
name	Atributo String requerido. Especifica el nombre de la instancia de proveedor. Éste es el valor utilizado para el atributo defaultProvider del elemento <roleManager> con el fin de identificar la instancia del proveedor como proveedor de funciones predeterminado. El name del proveedor también se utiliza para indizar el proveedor en la colección Providers.
scopeName	Atributo String opcional. Especifica el ámbito de seguridad de un almacén de directivas del Administrador de autorizaciones al que debe conectarse la instancia del proveedor y se aplica sólo a AuthorizationStoreRoleProvider. Si se especifica scopeName, el proveedor utilizará la combinación de applicationName y scopeName al conectarse al almacén de directivas.
type	Atributo String requerido. Especifica el tipo que implementa la clase base abstracta RoleProvider.

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 funciones para la administración de funciones.

Comentarios

El elemento add agrega una instancia del proveedor de funciones a la colección de proveedores de administración de funciones que está almacenada en el elemento providers.

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 una aplicación, vea RoleManagerSection, WindowsTokenRoleProvider, SqlRoleProvider y AuthorizationStoreRoleProvider.

Configuración predeterminada

El siguiente elemento providers predeterminado se configura en el archivo Machine.config.

<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 de código siguiente se muestra cómo configurar una aplicación ASP.NET de manera que utilice la clase SqlRoleProvider para almacenar y recuperar 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 configuración	Add
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

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

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales