RequestCachingSection 类
包含请求缓存的配置信息。
语法
class RequestCachingSection : ConfigurationSection
方法
下表列出了 RequestCachingSection 类公开的方法。
| 名称 | 描述 |
|---|---|
| GetAllowDefinition | （继承自 ConfigurationSection。） |
| GetAllowLocation | （从 ConfigurationSection 继承。） |
| RevertToParent | （从 ConfigurationSection 继承。） |
| SetAllowDefinition | （从 ConfigurationSection 继承。） |
| SetAllowLocation | （从 ConfigurationSection 继承。） |
属性
下表列出了 RequestCachingSection 类公开的属性。
| 名称 | 描述 |
|---|---|
DefaultFtpCachePolicy |
一个 FtpCachePolicySettings 值，该值指定本地计算机的默认 FTP 缓存行为。 |
DefaultHttpCachePolicy |
一个 HttpCachePolicySettings 值，该值指定本地计算机的默认 HTTP 缓存行为。 |
DefaultPolicyLevel |
一个读/写 sint32 值，指定默认缓存策略级别。 后文的“备注”部分列出了可能的值。 |
DisableAllCaching |
一个读/写 boolean 值。 如果在本地计算机上禁用缓存，则为 true；否则，为 false。 注意：如果此配置属性在任何配置文件中设置为 true，则全局禁用缓存，并忽略所有其他与缓存相关的设置。 |
IsPrivateCache |
一个读/写 boolean 值。 如果本地计算机缓存为专用（即提供用户隔离），则为 true；否则，为 false。 注意：在客户端计算机上，此值通常设置为 true，指示一个用户无法使用其他用户缓存的资源。 对于中间层应用程序，此值通常设置为 false。 |
Location |
（继承自 ConfigurationSection。）一个键属性。 |
Path |
（继承自 ConfigurationSection。）一个键属性。 |
SectionInformation |
（从 ConfigurationSection 继承。） |
UnspecifiedMaximumAge |
一个读/写 datetime 值，该值指定缓存资源没有过期信息的默认最长期限。 默认值为 1 天。 设置此属性可确保没有过期标头信息的资源不会无限期地保留在缓存中。 |
子类
此类不包含子类。
注解
下表列出了 DefaultPolicyLevel 属性的可能值。 默认值为 1 (BypassCache)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 0 | Default |
通过使用资源的缓存副本或通过将资源请求发送到服务器来满足资源请求。 采取的操作取决于当前的缓存策略和缓存内容的生存期。 大多数应用程序应使用此缓存级别。 |
| 1 | BypassCache |
使用服务器满足请求。 在客户端和服务器之间没有项从缓存中取出、添加到缓存中或从缓存中移除。 这是 .NET Framework 附带的计算机配置文件中指定的默认缓存行为。 |
| 2 | CacheOnly |
使用本地缓存资源满足请求；不发送对不在缓存中的项的请求。 当指定此缓存策略级别时，如果项不在客户端缓存中，则引发 WebException 异常。 |
| 3 | CacheIfAvailable |
如果资源可用，则从缓存满足资源请求；否则，将资源请求发送到服务器。 如果请求的项在本地缓存中不可用，但在客户端和服务器之间的缓存中可用，则中间缓存将会满足请求。 |
| 4 | Revalidate |
如果时间戳与服务器上的资源的时间戳相同，则使用资源的缓存副本满足请求；否则从服务器下载资源，将资源展示给调用方，然后再存储在缓存中。 |
| 5 | Reload |
使用服务器满足请求。 响应可能保存在缓存中，具体取决于 no-cache 缓存控制指令的设置以及 HTTP 缓存协议中的 Pragma: no-cache 标头。 |
| 6 | NoCacheNoStore |
从不通过使用缓存中的资源来满足请求，也不缓存资源。 如果资源在本地缓存中，则会移除该资源。 此策略级别指示中间缓存应移除资源。 在 HTTP 缓存协议中，这是通过 no-cache 缓存控制指令实现的。 |
继承层次结构
RequestCachingSection
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - 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 |
另请参阅
ConfigurationSection 类
FtpCachePolicySettings 类
HttpCachePolicySettings 类
System.Net.Cache.RequestCacheLevel 枚举
System.Net.WebException 类
CIM_DATETIME