Elemento add aplicado a providers para sessionState (Esquema de configuración de ASP.NET)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
Agrega un proveedor a la colección de proveedores de almacenes de estados de sesión.
<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 |
El atributo String es obligatorio. 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 |
El atributo String es obligatorio. Especifica el tipo que implementa la clase base abstracta SessionStateStoreProviderBase. El valor debe ser una referencia calificada con el nombre de 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 personalizados. |
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 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.
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 Implementing a Session State Store Provider.
<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 |
Microsoft Internet Information Services (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
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
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)
Conceptos
Implementing a Session-State Store Provider
ASP.NET Configuration File Hierarchy
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET