OutputCacheProfile (clase)
Configura el perfil de caché de salida para las páginas de una aplicación web.
Sintaxis
class OutputCacheProfile : CollectionElement
Métodos
Esta clase no contiene métodos.
Propiedades
La siguiente tabla muestra las propiedades que expone la clase OutputCacheProfile
.
Nombre | Descripción |
---|---|
Duration |
Valor sint32 de lectura y escritura que especifica el tiempo, en segundos, que la página o el control de usuario se almacenan en caché. El valor predeterminado es –1. Al establecer este atributo en una página o control de usuario, se establece una directiva de expiración para las respuestas HTTP de la página o el control de usuario y se almacenará automáticamente en caché la salida de la página o del control de usuario. Nota: Esta propiedad debe definirse en el perfil o en la directiva @ OutputCache de una página que usa el perfil. |
Enabled |
Valor boolean de lectura y escritura. true si el almacenamiento en caché está habilitado para todas las páginas o los controles que usan este perfil de caché de salida; de lo contrario, false . El valor predeterminado es true . |
Location |
Valor sint32 de lectura y escritura que especifica la ubicación de la memoria caché. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Name |
Valor string de solo lectura que especifica el nombre del perfil de caché de salida. |
NoStore |
Valor boolean de lectura y escritura. true si la página emite un encabezado Cache-Control: Private no-store en la respuesta HTTP que indica al explorador que no almacene la página en caché; de lo contrario, false . El valor predeterminado es false . Nota: Establecer este atributo en true equivale a invocar el método System.Web.HttpCachePolicy.SetNoStore durante una solicitud web. |
SqlDependency |
Valor string de lectura y escritura que identifica un conjunto de pares de nombre de tabla y base de datos SQL de los que depende la memoria caché de salida de una página o un control. Cuando se especifica una cadena para esta propiedad, las páginas almacenadas en caché de salida se pueden quitar de la memoria caché cada vez que cambia la tabla SQL de la que dependen. |
VaryByControl |
Valor string de lectura y escritura que especifica un conjunto delimitado por comas de identificadores de controles que se van a almacenar en caché. Nota: La configuración de esta propiedad es la misma que la del atributo VaryByControls de la directiva @ OutputCache . |
VaryByCustom |
Valor string de lectura y escritura delimitado por comas que representa los requisitos de almacenamiento en caché de salida personalizados. Si asigna a esta propiedad el valor de "browser", la memoria caché varía según el nombre del explorador y la información de la versión principal. Si escribe una cadena personalizada, debe invalidar el método GetVaryByCustomString en el archivo Global.asax de la aplicación. Nota: La configuración de esta propiedad es la misma que la del atributo VaryByCustom de la directiva @ OutputCache . |
VaryByHeader |
Valor string de lectura y escritura que especifica un conjunto de encabezados HTTP delimitado por comas que están asociados a la solicitud y que se usan para variar la salida almacenada en caché. Nota: La configuración de esta propiedad es la misma que la del atributo VaryByHeader de la directiva @ OutputCache . |
VaryByParam |
Valor string que especifica un conjunto de parámetros delimitados por comas que varían la salida almacenada en caché por cadena de consulta GET o parámetros POST de formulario. Nota: La configuración de esta propiedad es la misma que la del atributo VaryByParam de la directiva @ OutputCache . |
Subclases
Esta clase no contiene subclases.
Comentarios
Las instancias de esta clase se encuentran en la propiedad de matriz OutputCacheProfiles
de la clase OutputCacheProfileSettings.
En la siguiente tabla se describen los posibles valores de la propiedad Location
.
Valor | Palabra clave | Descripción |
---|---|---|
0 | Any |
La página se almacena en caché en el servidor, todos los servidores proxy compatibles con HTTP 1.1, y el cliente. Este valor corresponde al valor de enumeración System.Web.HttpCacheability.Public. |
1 | Client |
La página solo se almacena en caché en el cliente donde se originó la solicitud. Este valor corresponde al valor de enumeración System.Web.HttpCacheability.Private. |
2 | Downstream |
La página se almacena en caché en cualquier dispositivo compatible con cachés HTTP 1.1, excepto el servidor de origen. Entre los dispositivos compatibles con caché se incluyen los servidores proxy y el cliente que realizó la solicitud. |
3 | Server |
La página se almacena en caché solo en el servidor web donde se procesó la solicitud. Este valor corresponde al valor de enumeración System.Web.HttpCacheability.Server. |
4 | None |
La página no se almacena en caché. Este valor corresponde al valor de enumeración System.Web.HttpCacheability.NoCache. |
5 | ServerAndClient |
La página solo se almacena en caché en el servidor de origen o en el cliente solicitante. No está permitido que los servidores proxy almacenen la respuesta en la memoria caché. Este valor corresponde a la combinación de los valores de enumeración System.Web.HttpCacheability.Private y System.Web.HttpCacheability.Server. |
Jerarquía de herencia
OutputCacheProfile
Requisitos
Tipo | Descripción |
---|---|
Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
Archivo MOF | WebAdministration.mof |
Consulte también
System.Web.HttpCachePolicy.SetNoStoreSystem.Web.HttpCacheabilitySystem.Web.UI.OutputCacheLocation
CollectionElement (clase)
OutputCacheSection (clase)
OutputCacheSettingsSection (clase)
OutputCacheProfileSettings (clase)
SqlCacheDependencySection (clase)
@ OutputCache
Almacenamiento en caché de varias versiones de la salida del control de usuario