<requestCaching> 元素(网络设置)

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

<配置><system.net><requestCaching>

Syntax

<requestCaching
  isPrivateCache ="true|false"
  disableAllCaching="true|false"
  defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"
  unspecifiedMaximumAge= "d.hh:mm:ss">
    <defaultHttpCachePolicy>...</defaultHttpCachePolicy>
    <defaultFtpCachePolicy>...</defaultFtpCachePolicy>
</requestCaching>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

Attribute Description
isPrivateCache 指定缓存是否在不同用户的信息之间提供隔离。 默认值为 true。 此值应 false 适用于中间层应用程序。
disableAllCaching 指定对所有 Web 响应禁用缓存,并且无法以编程方式重写缓存。
defaultPolicyLevel 枚举中的 RequestCacheLevel 值之一。 默认值为 BypassCache
unspecifiedMaximumAge 指定将内容标记为过期的默认时间。

policyLevel 属性

价值 Description
Default 如果资源新鲜,则返回缓存的资源,内容长度准确,并且存在过期、修改和内容长度属性。
BypassCache 从服务器返回资源。
CacheOnly 如果内容长度存在并且与条目大小匹配,则返回缓存的资源。
CacheIfAvailable 如果提供内容长度并匹配条目大小,则返回缓存的资源;否则,资源将从服务器下载,并返回到调用方。
Revalidate 如果缓存资源的时间戳与服务器上的资源的时间戳相同,则返回缓存资源;否则,将从服务器下载资源,存储在缓存中,并返回到调用方。
Reload 从服务器下载资源,将其存储在缓存中,并将资源返回到调用方。
NoCacheNoStore 如果存在缓存的资源,则会将其删除。 资源从服务器下载,并返回到调用方。
Revalidate 如果时间戳与服务器上的资源的时间戳相同,则使用资源的缓存副本满足请求;否则,将从服务器下载资源,呈现给调用方,并存储在缓存中,

子元素

元素 Description
defaultHttpCachePolicy 可选元素。

描述 HTTP 缓存是否处于活动状态,并描述默认缓存策略。
<defaultFtpCachePolicy> 元素 (网络设置) 可选元素。

描述 FTP 缓存是否处于活动状态,并描述默认缓存策略。

父元素

元素 Description
system.net 包含用于指定 .NET Framework 如何连接到网络的设置。

Example

以下示例演示如何禁用所有缓存。

<configuration>
  <system.net>
    <requestCaching
      disableAllCaching="true"
    />
  </system.net>
</configuration>

另请参阅