Elemento add que se aplica a los objetos outputCacheProfile para el almacenamiento en caché (Esquema de configuración de ASP.NET)
Agrega un objeto OutputCacheProfile a la colección de configuraciones. Sólo se puede hacer referencia a los perfiles de memoria caché desde la directiva @ OutputCache de las páginas. Los perfiles no son compatibles con controles de usuario o controles de servidor.
<add name="String"
enabled="true|false"
duration="number"
location="Any|Client|Downstream|Server|None|ServerAndClient"
sqlDependency="String"
varyByCustom="String"
varyByControl="String"
varyByHeader="String"
varyByParam="String"
noStore="true|false" />
Atributos y elementos
En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Atributo |
Descripción |
|---|---|
name |
El atributo String es obligatorio. Establece el nombre único del perfil de la memoria caché. |
enabled |
Atributo Boolean opcional. Habilita la memoria caché de resultados para un perfil. |
duration |
Atributo TimeSpan opcional. Establece los segundos que una página está almacenada en la memoria caché. |
location |
Atributo Int32 opcional. Determina dónde está permitido que se almacene la respuesta de la memoria caché. |
sqlDependency |
Atributo String opcional. Establece la dependencia de caché SQL en el nivel de página. |
varyByCustom |
Atributo String opcional. Establece la cadena que se utiliza cuando se llama varyByCustom para la página. |
varyByControl |
Atributo String opcional. Establece el identificador del control que se almacena en la memoria caché y que se utiliza para llamar a varyByControl. También se puede establecer como una lista de identificadores delimitada por punto y coma. |
varyByHeader |
Atributo String opcional. Denomina a un conjunto de encabezados delimitados por punto y coma que se utiliza para variar el resultado almacenado en la memoria caché. |
varyByParam |
Atributo String opcional. Denomina a un conjunto de parámetros delimitados por punto y coma que se utilizan para variar el resultado almacenado en la memoria caché. |
noStore |
Atributo Boolean opcional. Establece un valor que indica si la directiva "Cache-Control: no-store" se envía como respuesta para las páginas almacenadas en caché. |
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 de ASP.NET y determinan su funcionamiento. |
caching |
Configura los valores de la memoria caché para una aplicación Web. |
outputCacheSettings |
Especifica la configuración de la memoria caché de resultados que se pueden aplicar a páginas de una aplicación ASP.NET. |
outputCacheProfiles |
Contiene grupos de configuración de caché que se pueden aplicar a páginas para especificar la directiva OutputCache. |
Comentarios
Configuración predeterminada
El siguiente elemento predeterminado add no está configurado de forma explícita en el archivo de configuración del equipo o en el archivo Web.config raíz, sino que es la configuración predeterminada que devuelve una aplicación en la versión 2.0 de .NET Framework.
<add name = ""
enabled = "true"
duration = "-1"
location = ""
sqlDependency = ""
varyByCustom = ""
varyByControl = ""
varyByHeader = ""
varyByParam = ""
noStore = "false"/>
Ejemplo
El siguiente ejemplo almacena una página en la caché del servidor durante un minuto y almacena diferentes versiones de la página según el tipo de explorador y la versión principal.
<outputCacheSettings>
<outputCacheProfiles>
<add name="ServerOnly"
duration="60"
varyByCustom="browser"
location="Server" />
</outputCacheProfiles>
</outputCacheSettings>
Cuando diseñe una página que necesite almacenarse en la memoria caché de esta manera, será necesario que agregue la siguiente directiva 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 |
|
Miembro de configuración |
|
Ubicaciones configurables |
Machine.config Web.config del nivel de raíz Web.config del 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
Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET
Referencia
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
caching (Elemento, Esquema de configuración de ASP.NET)
Elemento outputCacheSettings para el almacenamiento en caché (Esquema 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
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Administración de sitios web ASP.NET