HttpCachePolicySettings (clase)
Representa la directiva de caché HTTP predeterminada para los recursos de red.
Sintaxis
class HttpCachePolicySettings : EmbeddedObject
Métodos
Esta clase no contiene métodos.
Propiedades
La siguiente tabla muestra las propiedades que expone la clase HttpCachePolicySettings.
| Nombre | Descripción |
|---|---|
MaximumAge |
Valor datetime de lectura y escritura que especifica la antigüedad máxima permitida para que un recurso se devuelva desde la memoria caché. El valor predeterminado es infinite.Si la copia almacenada en caché del recurso es anterior al valor de tiempo especificado, el recurso se debe volver a validar mediante la comparación del recurso almacenado en caché con el recurso del servidor. |
MaximumStale |
Valor datetime de lectura y escritura que especifica la cantidad de tiempo durante el que se puede usar la copia almacenada en caché del recurso después de la expiración del contenido. El valor predeterminado es 0. |
MinimumFresh |
Valor datetime de lectura y escritura que especifica la cantidad de tiempo durante el que se puede usar la copia almacenada en caché del recurso antes de la expiración del contenido. El valor predeterminado es 0. |
PolicyLevel |
Valor sint32 de lectura y escritura que especifica el comportamiento de almacenamiento en caché de HTTP para el equipo local. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Subclases
Esta clase no contiene subclases.
Comentarios
Las instancias de esta clase se encuentran en la propiedad DefaultHttpCachePolicy de la clase RequestCachingSection.
En la siguiente tabla se describen los posibles valores de la propiedad PolicyLevel. El valor predeterminado es 0 (Default).
| Valor | Palabra clave | Descripción |
|---|---|---|
| 0 | Default |
Atiende una solicitud de un recurso mediante la copia almacenada en caché del recurso o enviando una solicitud para el recurso al servidor. La directiva de caché actual determina la acción realizada y la antigüedad del contenido en la memoria caché. Este es el nivel de caché que la mayoría de las aplicaciones deben usar. |
| 1 | BypassCache |
Atiende una solicitud mediante el servidor. No se toman entradas de las memorias caché, ni se agregan ni se quitan. Este es el comportamiento de caché predeterminado especificado en el archivo de configuración del equipo que se incluye con .NET Framework. |
| 2 | CacheOnly |
Atiende una solicitud mediante el recurso almacenado en caché local; no envía una solicitud de un elemento que no está en la memoria caché. Cuando se especifica este nivel de directiva de caché, se produce una excepción WebException si el elemento no está en la caché de cliente. |
| 3 | CacheIfAvailable |
Atiende una solicitud de un recurso de la memoria caché si el recurso está disponible en la memoria caché; de lo contrario, envía una solicitud de un recurso al servidor. Si el elemento solicitado no está disponible en la caché local, pero está disponible en una caché entre el cliente y el servidor, la caché intermedia atiende la solicitud. |
| 4 | Revalidate |
Atiende una solicitud utilizando la copia almacenada en caché del recurso si la marca de tiempo es igual que la marca de tiempo del recurso en el servidor; de lo contrario, el recurso se descarga del servidor, se presenta al llamador y se almacena en la caché. |
| 5 | Reload |
Atiende una solicitud mediante el servidor. La respuesta se puede guardar en la memoria caché, en función de la configuración de la directiva de control de caché no-cache y del encabezado Pragma: no-cache en el protocolo de almacenamiento en caché HTTP. |
| 6 | NoCacheNoStore |
Nunca atiende una solicitud mediante el uso de recursos de la memoria caché y no almacena en caché los recursos. Si el recurso está presente en la caché local, se quita. Este nivel de directiva les indica a las memorias caché intermedias que deben quitar el recurso. En el protocolo de almacenamiento en caché HTTP, esto se logra mediante el uso de la directiva de control de caché no-cache. |
| 7 | CacheOrNextCacheOnly |
Atiende una solicitud de un recurso de la memoria caché del equipo local o de una caché remota en la red de área local. Si no se puede atender la solicitud, se produce una excepción WebException. En el protocolo de almacenamiento en caché HTTP, esto se logra mediante el uso de la directiva de control de caché only-if-cached. |
| 8 | Refresh |
Atiende una solicitud mediante el servidor o una memoria caché distinta de la caché local. Antes de que una caché intermedia pueda atender la solicitud, esa caché debe revalidar su entrada almacenada en caché con el servidor. En el protocolo de almacenamiento en caché HTTP, esto se logra mediante el uso de la directiva de control de caché max-age = 0 y el encabezado Pragma:``no-cache. |
Ejemplo
En el ejemplo de código siguiente se especifica la directiva de almacenamiento en caché http y se establecen valores para las propiedades MinimumFresh, MaximumStale y MaximumAge.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the RequestCachingSection.
Set oSection = oWebAdmin.Get("RequestCachingSection.Path=" & _
"'MACHINE/WEBROOT/APPHOST',Location=''")
' Display the class name of the section.
WScript.Echo "[ " & oSection.Path_.Class & " ]"
' Display the initial values for the DefaultHttpCachePolicy property.
Call DisplayValues("Initial Values", oSection.DefaultHttpCachePolicy)
' Set the http cache policy to use the default.
oSection.DefaultHttpCachePolicy.PolicyLevel = 0
' Set the MinimumFresh property to 30 minutes.
oSection.DefaultHttpCachePolicy.MinimumFresh = "00000000003000.000000:000"
' Set the MaximumStale property to 10 minutes.
oSection.DefaultHttpCachePolicy.MaximumStale = "00000000001000.000000:000"
' Set the MaximumAge property to 1 hour.
oSection.DefaultHttpCachePolicy.MaximumAge = "00000000010000.000000:000"
' Save the values to configuration.
oSection.Put_
' Refresh the oSection object variable with the new values.
oSection.Refresh_
' Show the changed values.
Call DisplayValues("New Values", oSection.DefaultHttpCachePolicy)
' ==== DisplayValues helper function. ====
Function DisplayValues(HeadingText, oObject)
WScript.Echo
WScript.Echo String(Len(HeadingText), "=")
WScript.Echo HeadingText
WScript.Echo String(Len(HeadingText), "=")
For Each Prop In oObject.Properties_
WScript.Echo Prop.Name & ": " & Prop.Value
Next
End Function
Jerarquía de herencia
HttpCachePolicySettings
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
EmbeddedObject (clase)
FtpCachePolicySettings (clase)
RequestCachingSection (clase)
CIM_DATETIME