<defaultHttpCachePolicy> 元素(网络设置)

描述 HTTP 缓存功能是否处于活动状态并描述默认的缓存策略。

< defaultHttpCachePolicy
  policyLevel="BypassCache|Default"
  minimumFresh="d.hh:mm:ss"|"minValue"
  maximumAge  ="d.hh:mm:ss"|"maxValue"
  maximumStale="d.hh:mm:ss"|"maxValue"
/>

特性和元素

以下几节描述了属性、子元素和父元素。

特性

特性

说明

maximumAge

指定在将缓存的对象标记为过期之前的最长时间间隔。

maximumStale

指定在计算出的新鲜时间过期之后可经过的最长时间,超过此时间之后,会将缓存的对象标记为已过期。

minimumFresh

指定缓存的对象被视为新鲜的最短时间。

policyLevel

指定缓存策略是否为自动策略或者是否忽略缓存。 默认值为 BypassCache。

子元素

父元素

元素

说明

<requestCaching>

控制网络请求的缓存机制。

备注

<defaultHttpCachePolicy> 元素描述 HTTP 缓存功能是否处于活动状态并描述默认缓存策略。 这是可选元素。

policyLevel 特性的值为 BypassCache 或 Default。

maximumAge、maximumStale 和 minimumFresh 元素的值是格式为 d.hh:mm:ss(天、小时、分钟和秒)的显式时间间隔,或者是常量 minValue 或 maxValue(取适合的一个)。

配置文件

此元素可以用在应用程序配置文件或计算机配置文件 (Machine.config) 中。

示例

下面的代码示例演示如何将最短新鲜时间指定为六个小时、将最长生存期指定为两天,以及将最长陈旧时间指定为四个小时。

<configuration>
  <system.net>
    <requestCaching>
      <defaultHttpCachePolicy>
        <set minimumFresh="0.06:00:00" />
        <set maximumAge  ="2.00:00:00" />
        <set maximumStale="0.04:00:00" />
      </defaultHttpCachePolicy>
    </requestCaching>
  </system.net>
</configuration>

请参见

参考

网络设置架构

System.Net.Cache

WebRequest

RequestCacheLevel