caching (Elemento, Esquema de configuración de ASP.NET)

Actualización: noviembre 2007

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

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)

<caching>
      <cache>...</cache>
      <outputCache>...</outputCache>
      <outputCacheSettings>...</outputCacheSettings>
   <sqlCacheDependency>...</sqlCacheDependency>
</caching>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento

Descripción

Cache

Elemento opcional.

Define la configuración de caché global de la aplicación.

outputCache

Elemento opcional.

Especifica la configuración de la caché de resultados de la aplicación.

outputCacheSettings

Elemento opcional.

Especifica la configuración de la caché de resultados que se puede aplicar a las páginas de la aplicación.

sqlCacheDependency

Elemento opcional.

Configura las dependencias de caché de SQL para una aplicación ASP.NET.

Elementos primarios

Elemento

Descripción

configuration

Es el elemento raíz necesario en 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 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.

Comentarios

Configuración predeterminada

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

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

  <outputCache enableOutputCache = "true" 
    enableFragmentCache = "true" 
    sendCacheControlHeader = "true" 
    omitVaryStar = "false" >
  </outputCache>

  <outputCacheSettings>
    <outputCacheProfiles>
      <clear />
      <add name = "" 
        enabled = "true" 
        duration = "-1" 
        location = "" 
        sqlDependency = "" 
        varyByCustom = "" 
        varyByControl = "" 
        varyByHeader = "" 
        varyByParam = "" 
        noStore = "false"/>
    </outputCacheProfiles>
  </outputCacheSettings>

  <sqlCacheDependency enabled = "true" 
    pollTime = "60000">
    <databases>
       <clear />
      <add name = "" 
        connectionStringName = "" 
        pollTime = "60000"/>
    </databases>
  </sqlCacheDependency>

</caching>

Ejemplo

El siguiente ejemplo guarda una página en caché en el servidor sólo durante un minuto y almacena diferentes versiones de la página en función del tipo y la versión principal del explorador.

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
      duration="60" 
      varyByCustom="browser" 
      location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

Al diseñar una página que haya que almacenar en caché de esta forma, tendrá que agregar la directiva siguiente a la página:

<%@ OutputCache CacheProfile="ServerOnly" %>

Para obtener más información, vea @ OutputCache.

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.CacheSection

System.Web.Configuration.OutputCacheSection

System.Web.Configuration.OutputCacheSettingsSection

System.Web.Configuration.SqlCacheDependencySection

Miembro de la configuración

System.Web.Configuration.SystemWebCachingSectionGroup

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos

IIS 5.0, 5.1 y 6.0

.NET Framework 2.0

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

Información general sobre el almacenamiento en caché en ASP.NET

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 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)

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

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

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

System.Configuration

System.Web.Configuration

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administrar sitios web ASP.NET

Archivos de configuración de ASP.NET

API de configuración de ASP.NET