Clase CachingProfileElement

Configura el almacenamiento en caché para una extensión de solicitud determinada.

Sintaxis

class CachingProfileElement : CollectionElement  

Métodos

Esta clase no contiene métodos.

Propiedades

La siguiente tabla muestra las propiedades que expone la clase CachingProfileElement.

Nombre	Descripción
Duration	Valor de lectura y escritura datetime que especifica la cantidad de tiempo que una respuesta debe permanecer en la memoria caché. El valor predeterminado es 30 segundos. El intervalo de tiempo válido va de 0 a 365 días.
Extension	Valor de lectura y escritura string único necesario que especifica la extensión de una solicitud que usará el perfil de caché. La extensión debe estar en el formato "EXT" o "*", donde EXT es la extensión. La propiedad de la clave. Nota: No se permiten entradas de extensión superpuestas. Cada solicitud se asigna exactamente a un objeto CachingProfileElement. Si existe una entrada con "*", otros perfiles de almacenamiento en caché con extensiones más específicas invalidarán el perfil con el asterisco. El orden de las entradas de perfil no es importante.
KernelCachePolicy	Valor de lectura y escritura sint32 que configura la directiva de almacenamiento en caché del kernel. Los valores posibles se enumeran más adelante en la sección Comentarios.
Location	Valor de lectura y escritura sint32 que especifica posibles ubicaciones para la caché de salida. Los valores posibles se enumeran más adelante en la sección Comentarios.
Policy	Valor de lectura y escritura sint32 que configura la directiva de almacenamiento en caché de salida. Los valores posibles se enumeran más adelante en la sección Comentarios.
VaryByHeaders	Valor de lectura y escritura string que contiene una lista delimitada por comas de nombres de encabezado que el servidor usará para variar las respuestas almacenadas en caché a la dirección URL.
VaryByQueryString	Valor de lectura y escritura string que contiene una lista delimitada por comas de nombres de parámetro de cadena de consulta que el servidor usará para variar las respuestas almacenadas en caché a la dirección URL.

Subclases

Esta clase no contiene subclases.

Comentarios

Esta clase corresponde al elemento <profiles> de la sección <system.webServer/caching> del archivo ApplicationHost.config. Las instancias de esta clase se encuentran en la propiedad de matriz Profiles de la clase CachingProfileSettings.

En la siguiente tabla se describen los posibles valores de la propiedad KernelCachePolicy. El valor predeterminado es 0 (DontCache).

Valor	Palabra clave	Descripción
0	DontCache	La respuesta no se almacenará en caché en el kernel. Sin embargo, todavía se puede producir el almacenamiento en caché de salida. Nota: Esta configuración invalida cualquier configuración en conflicto en la propiedad Location.
1	CacheUntilChange	La respuesta se almacena en caché en la memoria caché de HTTP.SYS hasta que la entrada se invalida o hasta que expire después del período de inactividad especificado por la propiedad Duration.
2	CacheForTimePeriod	La respuesta se almacena en caché durante el período de tiempo especificado por la propiedad Duration, incluso si la entrada se invalida en el intervalo.
3	DisableCache	La memoria caché está deshabilitada y no se almacenará en caché.

En la siguiente tabla se describen los posibles valores de la propiedad Location. El valor predeterminado es 3 (Server).

Valor	Palabra clave	Descripción
0	Any	La respuesta se puede almacenar en caché en el cliente, el servidor web o el servidor proxy.
1	Client	La respuesta solo se almacena en caché en el cliente.
2	Downstream	La respuesta se almacena en caché en servidores proxy y en el cliente, pero no en el servidor web.
3	Server	La respuesta solo se almacena en caché en el servidor web.
4	None	La respuesta no se almacena en caché en ningún lugar.
5	ServerAndClient	La respuesta se almacena en caché tanto en el servidor web como en el cliente, pero no en los servidores proxy. Nota: Puede usar esta configuración para evitar compartir contenido entre varios usuarios en cachés de proxy cuando el servidor tiene un comportamiento variable para el contenido privado.

En la siguiente tabla se describen los posibles valores de la propiedad Policy. El valor predeterminado es 0 (DontCache).

Valor	Palabra clave	Descripción
0	DontCache	La respuesta no se colocará en la caché de salida. Sin embargo, todavía se puede producir el almacenamiento en caché del kernel.
1	CacheUntilChange	La respuesta se almacena en caché hasta que la entrada se invalida o hasta que expire después del período de inactividad especificado por la propiedad Duration.
2	CacheForTimePeriod	La respuesta se almacena en caché durante el período de tiempo especificado por la propiedad Duration, incluso si la entrada se invalida en el intervalo.
3	DisableCache	La memoria caché está deshabilitada y no se almacenará en caché.

Ejemplo

El siguiente ejemplo muestra todos los objetos CachingProfileElement para el sitio web predeterminado.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the caching section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CachingSection", oSection  

' Display the path and location.  
Wscript.Echo "Path: " & oSection.Path  
Wscript.Echo "Location: " & oSection.Location  
Wscript.Echo

' Display all of the caching profiles for the default Web site.  
For Each oCachingProfileElement In oSection.Profiles.Profiles  
    Wscript.Echo
    WScript.Echo "[ " & oCachingProfileElement.Extension & _  
        " ] Caching Profile"  
    WScript.Echo "-----------------------------------"  
    WScript.Echo "Duration: " & oCachingProfileElement.Duration  
    WScript.Echo "KernelCachePolicy: " & _  
        CachePolicyText(oCachingProfileElement.KernelCachePolicy)  
    WScript.Echo "Location: " & _  
        LocationText(oCachingProfileElement.Location)  
    WScript.Echo "Policy: " & _  
        CachePolicyText(oCachingProfileElement.Policy)  
    WScript.Echo "VaryByHeaders: " & _  
        oCachingProfileElement.VaryByHeaders  
    WScript.Echo "VaryByQueryString: " & _  
        oCachingProfileElement.VaryByQueryString  
    WScript.Echo
Next  

' Provide text for KernelCachePolicy and Policy enumeration values.  
Function CachePolicyText(enumval)  

    Select Case enumval  
        Case 0  
            CachePolicyText="DontCache"  
        Case 1  
            CachePolicyText="CacheUntilChange"  
        Case 2  
            CachePolicyText="CacheForTimePeriod"  
        Case 3  
            CachePolicyText="DisableCache"  
        Case Else  
            CachePolicyText="Undefined enumeration value"  
    End Select  

End Function  

' Provide text for Location enumeration values.  
Function LocationText(enumval)  

    Select Case enumval  
        Case 0  
            LocationText="Any"  
        Case 1  
            LocationText="Client"  
        Case 2  
            GetLocationText="Downstream"  
        Case 3  
            LocationText="Server"  
        Case 4  
            LocationText="None"  
        Case 5  
            LocationText="ServerAndClient"  
        Case Else  
            LocationText="Undefined enumeration value"  
    End Select  

End Function

Jerarquía de herencia

CollectionElement

CachingProfileElement

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

Clase AspCache
Clase CachingProfileSettings
Clase CachingSection
Clase CollectionElement
Clase HttpClientCache