<requestCaching> 項目 (網路設定)

更新：2007 年 11 月

控制網路要求的快取機制。

<configuration> 項目
  <system.Net> 項目 (網路設定)
    <requestCaching> 項目 (網路設定)

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

屬性和項目

下列小節將說明屬性、子項目和父項目。

屬性

屬性	描述
isPrivateCache	指定快取是否會在不同使用者的資訊之間提供隔離。預設值為 true。對於中介層 (Middle Tier) 應用程式而言，此值應該是 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