Compartir a través de


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

Actualización: noviembre 2007

Agrega un proveedor a la colección de proveedores de almacenes de estados de sesión.

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento sessionState (Esquema de configuración de ASP.NET)
      Elemento providers para sessionState (Esquema de configuración de ASP.NET)
        Elemento add aplicado a providers para sessionState (Esquema de configuración de ASP.NET)

<add 
    name="provider name" 
    type="fully qualified type reference"
/>

Atributos y elementos

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

Atributos

Atributo

Descripción

name

Atributo String requerido.

Especifica el nombre de la instancia de proveedor. Éste es el valor que se utiliza para el atributo customProvider del elemento sessionState para identificar la instancia de proveedor como proveedor de almacén de estados de sesión cuando el atributo de modo del elemento sessionState está establecido en el valor Custom.

type

Atributo String requerido.

Especifica el tipo que implementa la clase base abstracta SessionStateStoreProviderBase.

El valor debe ser una referencia completa al ensamblado.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Elemento raíz necesario en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .NET Framework.

system.web

Especifica el elemento raíz de los valores de configuración de ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.

sessionState

Configura valores de estado de sesión para la aplicación actual.

providers

Contiene una colección de proveedores de almacenes de estados de sesión.

Comentarios

El elemento add agrega un proveedor a la colección de proveedores de almacenes de estados de sesión en el elemento providers. El elemento providers contiene una colección de proveedores de almacenes de estados de sesión personalizados. El proveedor de almacén de estado de sesión personalizado debe heredar de la clase SessionStateStoreProviderBase.

Para obtener información sobre cómo obtener acceso a los valores de configuración del elemento sessionState en el código de una aplicación o sobre cómo modificarlos, vea ProviderSettingsCollection y Providers.

Ejemplo

En el ejemplo de código siguiente se muestra cómo utilizar el archivo Web.config para una aplicación ASP.NET configurada para usar un proveedor de almacén de estado de sesión personalizado. Para obtener información sobre cómo implementar un proveedor de almacén de estado de sesión, incluido un proveedor de ejemplo, vea Implementar un proveedor de almacén de estados de sesión.

<configuration>
  <connectionStrings>
    <add name="OdbcSessionServices" connectionString="DSN=SessionState;" />
  </connectionStrings>

  <system.web>
    <sessionState 
      cookieless="true"
      regenerateExpiredSessionId="true" 
      mode="Custom"
      customProvider="OdbcSessionProvider">
      <providers>
        <add name="OdbcSessionProvider"
          type="Samples.AspNet.Session.OdbcSessionStateStore"
          connectionStringName="OdbcSessionServices" 
          writeExceptionsToEventLog="false" />
      </providers>
    </sessionState>
  </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

SessionStateSection

Miembro de configuración

Providers

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos   

Servicios de Microsoft Internet Information Server (IIS) versión 5.0, 5.1 ó 6.0

Microsoft .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

Conceptos

Implementar un proveedor de almacén de estados de sesión

Proteger el estado de sesión

Jerarquía de archivos y herencia de la configuración de ASP.NET

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

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

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

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

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

Elemento sessionState (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

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

Otros recursos

Cifrar información de configuración mediante una configuración protegida

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administrar sitios web ASP.NET

API de configuración de ASP.NET