Esta documentación está archivada y no tiene mantenimiento.

Elemento cache para el almacenamiento en caché (Esquema de configuración de ASP.NET)

Actualización: noviembre 2007

Define la configuración de caché en el nivel de aplicación para una aplicación Web ASP.NET.

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    caching (Elemento, Esquema de configuración de ASP.NET)
      Elemento cache para el almacenamiento en caché (Esquema de configuración de ASP.NET)

<cache disableMemoryCollection="true|false" 
       disableExpiration="true|false" 
       privateBytesLimit="number" 
       percentagePhysicalMemoryUsedLimit="number" 
       privateBytesPollTime="HH:MM:SS" />

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

Atributos

Atributo

Descripción

disableMemoryCollection

Atributo Boolean opcional.

Obtiene o establece un valor que indica si está deshabilitada la recopilación de memoria caché que se produce cuando el equipo necesita memoria.

disableExpiration

Atributo Boolean opcional.

Obtiene o establece un valor que indica si está deshabilitado el vencimiento de la memoria caché. Cuando está deshabilitado, no vence el período de vigencia de los elementos almacenados en caché y no se borran en segundo plano los elementos de caché caducados.

privateBytesLimit

Atributo Int64 opcional.

Obtiene o establece un valor que indica el tamaño máximo de los bytes privados de una aplicación antes de que la caché empiece a borrar elementos que han dejado de ser vigentes e intente recuperar memoria. Este límite incluye tanto la memoria utilizada por la caché como la sobrecarga de memoria normal de la aplicación en ejecución. Un valor de configuración cero indica que ASP.NET utilizará sus propias técnicas heurísticas para determinar cuándo debe iniciar la recuperación de memoria.

percentagePhysicalMemoryUsedLimit

Atributo Int32 opcional.

Obtiene o establece un valor que indica el porcentaje máximo de la memoria física de un equipo que se puede utilizar antes de que la caché comience a vaciar elementos e intente reclamar memoria. Observe que el límite se aplica a la memoria física total en uso. Un valor de 0 hace que las entradas se quiten inmediatamente, en cuanto se insertan.

privateBytesPollTime

Atributo TimeSpan opcional.

Obtiene o establece un valor que indica el intervalo de tiempo entre sondeos sobre el uso de memoria correspondiente a bytes privados de la aplicación.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Es el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de las opciones de ASP.NET en un archivo de configuración. Contiene los elementos de configuración que configuran las aplicaciones Web ASP.NET y determinan su funcionamiento.

caching

Configura los valores de memoria caché para una aplicación Web.

Configuración predeterminada

El siguiente elemento cache predeterminado no está configurado explícitamente en el archivo de configuración del equipo ni en el archivo Web.config raíz, pero es la configuración predeterminada que devuelve la aplicación en .NET Framework versión 2.0.

<cache disableMemoryCollection="false" 
  disableExpiration="false" privateBytesLimit="0" 
  percentagePhysicalMemoryUsedLimit="90" 
  privateBytesPollTime="00:02:00" />

En el ejemplo siguiente se establece la configuración global de caché para una aplicación ASP.NET.

<cache disableMemoryCollection = "false" 
  disableExpiration = "false" 
  privateBytesLimit = "20971520" 
  percentagePhysicalMemoryUsedLimit = 60" 
  privateBytesPollTime = "00:01:00"/>

Controlador de la sección de configuración

System.Web.Configuration.CacheSection

Miembro de configuración

Cache

Ubicaciones configurables

Machine.config

Web.config del nivel de raíz

Web.config del nivel de aplicaciones

Requisitos

IIS versión 5.0, 5.1 y 6.0

Versión 2.0 de .NET Framework

Visual Studio 2005

Mostrar: