Opciones de configuración del proveedor de estado de sesión de almacenamiento en caché de ASP.NET 4 (Almacenamiento en caché de AppFabric 1.1)

Este tema describe las opciones de configuración del proveedor de estado de sesión AppFabric de ASP.NET. Estos valores están especificados en la sección providers del elemento sessionState, en el archivo web.config.

Opciones de configuración del estado de sesión

Atributo	Descripción
name (obligatorio)	El nombre común del proveedor utilizado por el elemento sessionState para hacer referencia al proveedor.
type (obligatorio)	La cadena de tipo .NET Framework del proveedor. Debe estar definida en “Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache”.
cacheName (obligatorio)	El nombre de la memoria caché AppFabric.
dataCacheClientName (opcional)	El nombre de la sección dataCacheClient que se va a utilizar desde la sección de configuración dataCacheClients. Este atributo solo es obligatorio si se especifican varias secciones dataCacheClient en el archivo web.config. De forma predeterminada, el proveedor utilizará la sección dataCacheClient denominada “default”.
applicationName (opcional)	Un valor de cadena utilizado por el proveedor al crear las claves de caché para almacenar los datos de estado de sesión. Cuando este atributo no está definido, el estado de sesión únicamente se comparte entre las diferentes instancias físicas de la misma aplicación web (con el requisito adicional de que cada instancia de la aplicación esté instalada en la misma ruta de acceso de metabase de IIS). Para obtener más información, consulte https://support.microsoft.com/kb/325056. Cuando este atributo está definido, el estado de sesión se compartirá entre todas las aplicaciones web que utilice el mismo valor applicationName.
useBlobMode (opcional)	Un valor booleano que especifica si cargar o almacenar los datos de estado de sesión como un blob serializado único. El valor predeterminado es true. Cuando está definido en false, el proveedor cargar y almacena los datos de estado de sesión como pares de clave individuales.
nonInlinedAdditionalLifetime (opcional)	Un valor Timespan que el proveedor utilizar para realizar un seguimiento del siguiente punto del tiempo en el que una sesión individual (no en línea) debe modificarse para mantener el elemento "activo". Este valor únicamente se utiliza cuando useBlobMode está definido en false. El valor predeterminado es del 50% de la configuración del valor del tiempo de espera del estado de sesión en minutos. El formato de cadena que se utiliza para este valor es "HH:MM:SS". Por ejemplo, diez minutos serían "00:10:00". Este valor se puede disminuir para reducir la cantidad de elementos de tiempo asociados con sesiones caducadas que permanecen en la caché.
retryInterval (opcional)	Un valor Timespan que indica la duración del intervalo de espera entre reintentos si se produce un error de comunicación con la caché. El formato de cadena que se utiliza para este valor es "HH:MM:SS". De manera predeterminada, el proveedor estará en suspensión durante un segundo.
retryCount (opcional)	Un valor entero que indica al proveedor el número de reintentos en caso de que se produzca un error de comunicación con la caché. Tenga en cuenta que no todas las operaciones podrán volver a intentarse. El valor predeterminado es de tres reintentos. El proveedor se suspende por el tiempo retryInterval configurado entre cada reintento.
inlinedKeys (opcional)	Un valor de cadena que tiene definido una coma o un punto y como delimitador de las claves de estado de sesión cuyos valores deberían estar en línea con el registro de metadatos de estado de sesión. Esta configuración únicamente es aplicable cuando useBlobMode está definido en false. Esta configuración se puede utilizar como optimización para reducir los valores de retorno con la caché para los elementos de estado de sesión que se utilizan frecuentemente.
maxInlinedStringLength (opcional)	Un valor entero que indica el tamaño de cadena máximo de un valor de estado de sesión que se alineará automáticamente con el registro de metadatos de estado de sesión. Esta configuración únicamente es aplicable cuando useBlobMode está definido en false. El valor predeterminado es de 512 caracteres por cadena.

Ejemplo

En el siguiente ejemplo, el elemento sessionState utiliza pares clave-valor para el estado de sesión, así como un nombre de aplicación compartido.

<sessionState 
mode="Custom" 
customProvider="DistributedSessionProvider">
      <providers>
        <add name="DistributedSessionProvider"
             type="Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, 
     Microsoft.Web.DistributedCache"
             cacheName="default"
             applicationName="Contoso"
             useBlobMode="true" />
      </providers>
</sessionState>

Vea también

Conceptos

Proveedor de estado de sesión (Almacenamiento en caché de AppFabric 1.1)

  2012-03-05