Elemento cache para el almacenamiento en caché (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].

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

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los 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á deshabilitada la expiración de la memoria caché. Cuando está deshabilitado, no expira el período de vigencia de los elementos almacenados en caché y no se borran en segundo plano los elementos de caché expirados.

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 expirado 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 en cada archivo de configuración que se utiliza en Common Language Runtime y las aplicaciones de .NET Framework.

system.web

Especifica el elemento raíz de las opciones de configuración 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 las opciones de memoria caché para una aplicación web.

Comentarios

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" />

Ejemplo

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"/>

Información de elemento

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 raíz

Web.config de nivel de aplicación

Requisitos

Versiones 5.0, 5.1 y 6.0 de IIS

.NET Framework 2.0

Visual Studio 2005

Vea también

Tareas

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referencia

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento configuration (Esquema de configuración general)

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

System.Configuration

System.Web.Configuration

Conceptos

Cache Configuration in ASP.NET

ASP.NET Caching Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API