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

Actualización: noviembre 2007

Quita todas las referencias a proveedores de almacenes de estados de sesión heredados, y admite sólo los proveedores agregados por el elemento add actual.

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

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 clear aplicado a providers para sessionState (Esquema de configuración de ASP.NET)

<clear/>

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Ninguno.

Elementos primarios

Comentarios

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

El elemento providers contiene una colección de proveedores de almacenes de estados de sesión personalizados. El proveedor de almacén de estados 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.

Configuración predeterminada

El elemento predeterminado siguiente providers no se configura explícitamente en el archivo Machine.config ni en el archivo Web.config raíz. Sin embargo, es la configuración predeterminada que devuelve la aplicación.

<sessionState
   <!-- Attribute settings. -->
>
   <providers>
      <clear />
   </providers>
</sessionState>

Ejemplo

En el ejemplo de código siguiente se muestra cómo configurar el archivo Web.config para una aplicación ASP.NET para que use un proveedor de almacén de estados de sesión personalizado. En el ejemplo se borran todas las instancias existentes de los proveedores de almacenes de estados de sesión utilizando el elemento clear, antes de agregar la instancia personalizada del proveedor de almacén de estados de sesión. Para obtener información sobre cómo implementar un proveedor de almacén de estados de sesión y 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>
        <clear />
        <add name="OdbcSessionProvider"
          type="Samples.AspNet.Session.OdbcSessionStateStore"
          connectionStringName="OdbcSessionServices" 
          writeExceptionsToEventLog="false" />
      </providers>
    </sessionState>
  </system.web>
</configuration>

Información de elemento

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