CachingSection (clase)

Artículo
03/25/2024

Configura la salida y el almacenamiento en caché del kernel.

Sintaxis

class CachingSection : ConfigurationSectionWithCollection

Métodos

La siguiente tabla muestra los métodos expuestos por la clase CachingSection.

Nombre	Descripción
Add (Agregar)	(Se hereda de ConfigurationSectionWithCollection).
Borrar	(Se hereda de `ConfigurationSectionWithCollection`).
Get	(Se hereda de `ConfigurationSectionWithCollection`).
GetAllowDefinition	(Se hereda de ConfigurationSection).
GetAllowLocation	(Se hereda de `ConfigurationSection`).
Remove	(Se hereda de `ConfigurationSectionWithCollection`).
RevertToParent	(Se hereda de `ConfigurationSection`).
SetAllowDefinition	(Se hereda de `ConfigurationSection`).
SetAllowLocation	(Se hereda de `ConfigurationSection`).

Propiedades

La siguiente tabla enumera las propiedades expuestas por la clase CachingSection.

Nombre	Descripción
`Enabled`	Valor `boolean` de lectura y escritura. `true` si la caché de salida está habilitada; de lo contrario, `false`. Si la caché de salida está deshabilitada, no se producirá ningún almacenamiento en caché de salida de respuesta o almacenamiento en caché del kernel. El valor predeterminado es `true`.
`EnableKernelCache`	Valor `boolean` de lectura y escritura. Es `true` si el almacenamiento en la caché de kernel está habilitado; en caso contrario, es `false`. El valor predeterminado es `true`.
`Location`	(Se hereda de `ConfigurationSection`). Una propiedad clave.
`MaxCacheSize`	Valor `uint32` de lectura y escritura que especifica el tamaño máximo, en megabytes, de la caché de salida. El valor predeterminado es 0. Un valor de 0 significa que el tamaño de la memoria caché se administra automáticamente. Un tamaño de `MaxValue` significa que no hay ningún límite en el tamaño de caché. Nota: Esta configuración solo es efectiva en el nivel del archivo ApplicationHost.config. Si establece esta propiedad en un nivel inferior, no tendrá ningún efecto.
`MaxResponseSize`	Valor `uint32` de lectura y escritura que especifica el tamaño máximo, en bytes, de una respuesta que se puede almacenar en la memoria caché de salida. El valor predeterminado es 262144 (256 KB). Un valor de 0 significa que no hay límite. Nota: Esta configuración solo es efectiva en el nivel del archivo ApplicationHost.config. Si establece esta propiedad en un nivel inferior, no tendrá ningún efecto.
`Path`	(Se hereda de `ConfigurationSection`). Una propiedad clave.
`Profiles`	Valor CachingProfileSettings que configura el almacenamiento en caché para extensiones de solicitud específicas.
`SectionInformation`	(Se hereda de `ConfigurationSection`).

Subclases

Esta clase no contiene subclases.

Ejemplo

En el ejemplo siguiente se muestran las propiedades del objeto CachingSection del sitio web predeterminado, incluidos los valores CachingProfileSettings de la propiedad de matriz Profiles. Se proporcionan dos funciones auxiliares para mostrar texto para las enumeraciones Policy, KernelCachePolicy y Location.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the CachingSection 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 other non-array CachingSection properties.  
WScript.Echo "Enabled: " & oSection.Enabled  
Wscript.Echo "EnableKernelCache: " & oSection.EnableKernelCache  
Wscript.Echo "MaxCacheSize: " & oSection.MaxCacheSize  
Wscript.Echo "MaxResponseSize: " & oSection.MaxResponseSize  
Wscript.Echo   
  
' Display the caching profiles from the Profiles property.  
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 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

ConfigurationSection

ConfigurationSectionWithCollection

CachingSection

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

AspCache (clase)
CachingProfileElement (clase)
CachingProfileSettings (clase)
ConfigurationSection (clase)
ConfigurationSectionWithCollection (clase)
HttpClientCache (clase)

Compartir a través de