<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>

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性	描述
isPrivateCache	指定快取在不同使用者資訊之間是否有所隔離。 預設值是 true。 針對中介層應用程式，此值應為 false。
disableAllCaching	指定停用所有 Web 回應的快取，而且無法以程式設計方式覆寫。
defaultPolicyLevel	RequestCacheLevel 列舉中的其中一個值。 預設值是 BypassCache。
unspecifiedMaximumAge	指定預設時間，在此時間之後標示內容為過期。

policyLevel 屬性

值	描述
Default	若資源為全新、內容長度正確，並存在到期、修改與內容長度屬性，則傳回快取的資源。
BypassCache	從伺服器傳回資源。
CacheOnly	若內容長度存在且符合輸入大小，則傳回快取的資源。
CacheIfAvailable	若提供內容長度並符合輸入大小，則傳回快取資源；否則，從伺服器下載資源，並傳回呼叫端。
Revalidate	若快取資源的時間戳記等同於伺服器資源的時間戳記，則傳回快取資源；否則，從伺服器下載資源，儲存在快取，並傳回呼叫端。
Reload	從伺服器下載資源、儲存在快取，並將其傳回呼叫端。
NoCacheNoStore	若快取的資源存在，則會將其刪除。 會從伺服器下載資源，並傳回呼叫端。
Revalidate	若時間戳記等同於伺服器資源的時間戳記，則使用資源的快取複本來滿足要求，否則，從伺服器下載資源，呈現給呼叫端，並儲存在快取。

子元素

元素	描述
defaultHttpCachePolicy	選擇性項目。 說明 HTTP 快取是否為作用中，並說明預設快取原則。
<defaultFtpCachePolicy> 元素 (網路設定)	選擇性項目。 說明 FTP 快取是否為作用中，並說明預設快取原則。

父項目

元素	描述
system.net	包含會指定 .NET Framework 如何連接至網路的設定。

範例

下列範例示範如何停用所有快取。

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

另請參閱

• System.Net.Cache
• 網路設定結構描述