CachingSection 类

配置输出和内核缓存。

语法

class CachingSection : ConfigurationSectionWithCollection  

方法

下表列出了 CachingSection 类公开的方法。

名称	说明
添加	（继承自 ConfigurationSectionWithCollection。）
清除	（从 ConfigurationSectionWithCollection 继承。）
Get	（从 ConfigurationSectionWithCollection 继承。）
GetAllowDefinition	（继承自 ConfigurationSection。）
GetAllowLocation	（从 ConfigurationSection 继承。）
删除	（从 ConfigurationSectionWithCollection 继承。）
RevertToParent	（从 ConfigurationSection 继承。）
SetAllowDefinition	（从 ConfigurationSection 继承。）
SetAllowLocation	（从 ConfigurationSection 继承。）

属性

下表列出了 CachingSection 类公开的属性。

名称	描述
Enabled	一个读/写 boolean 值。 如果已启用输出缓存，则为 true；否则为 false。 如果已禁用输出缓存，则不会发生响应输出缓存或内核缓存。 默认为 true。
EnableKernelCache	一个读/写 boolean 值。 如果已启用内核缓存，则为 true；否则为 false。 默认为 true。
Location	（继承自 ConfigurationSection。）一个键属性。
MaxCacheSize	一个读/写 uint32 值，该值指定输出缓存的最大大小（以兆字节为单位）。 默认值为 0。 值为 0 表示自动管理缓存内存大小。 大小为 MaxValue 表示缓存大小没有限制。 注意：此设置仅在 ApplicationHost.config 文件的级别有效。 如果在更低级别设置此属性，此属性将无效。
MaxResponseSize	一个读/写 uint32 值，该值指定可存储在输出缓存中的响应的最大大小（以字节为单位）。 默认值为 262144 (256KB)。 设置为 0 表示没有限制。 注意：此设置仅在 ApplicationHost.config 文件的级别有效。 如果在更低级别设置此属性，此属性将无效。
Path	（继承自 ConfigurationSection。）一个键属性。
Profiles	一个 CachingProfileSettings 值，用于为特定请求扩展配置缓存。
SectionInformation	（从 ConfigurationSection 继承。）

子类

此类不包含子类。

示例

以下示例显示默认网站的 CachingSection 对象中的属性，包括 Profiles 数组属性中的 CachingProfileSettings 值。 提供了两个帮助程序函数来显示 Policy、KernelCachePolicy 和 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  
  

继承层次结构

ConfigurationSection

ConfigurationSectionWithCollection

CachingSection

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上）
服务器	- IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上）
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

AspCache 类
CachingProfileElement 类
CachingProfileSettings 类
ConfigurationSection 类
ConfigurationSectionWithCollection 类
HttpClientCache 类