Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualización: noviembre 2007
Contiene una colección de proveedores de almacenes de estados de sesión.
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)
<providers>
<add
/>
<remove />
<clear/>
</providers>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos principales.
Atributos
Ninguno.
Elementos secundarios
Elemento |
Descripción |
|---|---|
Add |
Elemento opcional. Agrega un proveedor a la colección de proveedores de almacenes de estados de sesión. |
clear |
Elemento opcional. 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. |
Remove |
Elemento opcional. Quita de la colección una referencia a un proveedor de almacén de estados de sesión. |
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Especifica el elemento raíz requerido 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 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. |
Comentarios
El elemento providers contiene una colección de proveedores de almacenes de estados de sesión. 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.
Configuración predeterminada
El siguiente elemento predeterminado providers no está configurado explícitamente en el archivo Machine.config ni en el archivo Web.config de la 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 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 |
|
Miembro de configuración |
|
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 o 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
Conceptos
Implementar un proveedor de almacén de estados 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 sessionState (Esquema de configuración de ASP.NET)
Elemento add aplicado a 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 system.web (Esquema de configuración de ASP.NET)
Elemento providers para sessionState (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
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