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

Actualización: noviembre 2007

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

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 outputCache para el almacenamiento en caché (Esquema de configuración de ASP.NET)

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

Atributos y elementos

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

Atributos

Atributo

Descripción

enableOutputCache

Atributo Boolean opcional.

Habilita o deshabilita la caché de resultados de la página.

Si se deshabilita, no se almacena ninguna página en caché, independientemente de la configuración de programación o declarativa.

El valor predeterminado es true.

enableFragmentCache

Atributo Boolean opcional.

Habilita o deshabilita la caché por fragmentos para la aplicación.

Si se deshabilita, no se almacenará en caché ninguna página, independientemente de la directiva @ OutputCache o del perfil de almacenamiento en caché que se utilice. Incluye un encabezado de control de caché que indica que ni los servidores proxy que preceden en la cadena ni los clientes de exploradores deben intentar almacenar en caché resultados de página.

El valor predeterminado es false.

sendCacheControlHeader

Atributo Boolean opcional.

Obtiene o establece un valor que indica si el módulo de caché de resultados envía de forma predeterminada el encabezado cache-control:private.

El valor predeterminado es false.

omitVaryStar

Atributo Boolean opcional.

Habilita o deshabilita el envío de un encabezado HTTP "Vary: *" en la respuesta. Con la configuración predeterminada de false, se envía un encabezado "Vary: *" para las páginas con almacenamiento en caché de resultados.

El valor predeterminado es false.

Elementos secundarios

Ninguna.

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.

Comentarios

Configuración predeterminada

El siguiente elemento outputCache 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.

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

Ejemplo

En el ejemplo siguiente se deshabilita la caché de resultados para una aplicación ASP.NET.

<outputCache enableOutputCache="false" />

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.OutputCacheSection

Miembro de configuración

SystemWebCachingSectionGroup.OutputCache

Ubicaciones configurables

Machine.config

Web.config del nivel de raíz

Web.config del nivel de aplicaciones

Requisitos

IIS versión 5.0, IIS versión 5.1 e IIS versión 6.0

Versión 2.0 de .NET Framework

Visual Studio 2005

Vea también

Tareas

Tutorial: Usar el almacenamiento en la caché de resultados para mejorar el rendimiento de los sitios Web

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)

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