共用方式為


caching 的 cache 項目 (ASP.NET 設定結構描述)

更新:2007 年 11 月

為 ASP.NET Web 應用程式定義應用程式範圍的快取設定。

configuration 項目 (一般設定結構描述)
  system.web 項目 (ASP.NET 設定結構描述)
    caching 項目 (ASP.NET 設定結構描述)
      caching 的 cache 項目 (ASP.NET 設定結構描述)

<cache disableMemoryCollection="true|false" 
       disableExpiration="true|false" 
       privateBytesLimit="number" 
       percentagePhysicalMemoryUsedLimit="number" 
       privateBytesPollTime="HH:MM:SS" />

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性

說明

disableMemoryCollection

選擇性的 Boolean 屬性。

取得或設定值,表示在電腦處於記憶體壓力下時是否停用發生的快取記憶體回收。

disableExpiration

選擇性的 Boolean 屬性。

取得或設定值,表示是否停用快取到期。如果停用,快取的項目不會過期,且不會從背景 (Background) 清除過期的快取項目。

privateBytesLimit

選擇性的 Int64 屬性。

取得或設定值,表示快取開始清除過期項目和嘗試回收記憶體前應用程式之私用位元組的最大大小。這個限制包括快取使用的記憶體和執行應用程式的正常記憶體負荷。設定為零表示 ASP.NET 將使用其自己的啟發學習法 (Heuristic) 來決定何時開始回收記憶體。

percentagePhysicalMemoryUsedLimit

選擇性的 Int32 屬性。

取得或設定代表電腦實體記憶體最大百分比的值,此值可在快取開始清除項目和嘗試回收記憶體之前使用。請注意,此限制適用於使用時的總實體記憶體。0 的設定會導致項目在插入時,立即遭到移除。

privateBytesPollTime

選擇性的 TimeSpan 屬性。

取得或設定值,表示輪詢應用程式之私用位元組記憶體使用量的時間間隔。

子項目

父項目

項目

說明

configuration

Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。

system.web

針對組態檔中的 ASP.NET 組態設定指定根項目。包含設定 ASP.NET Web 應用程式和控制該應用程式行為方式的組態項目。

caching

設定 Web 應用程式的快取設定。

備註

預設的組態

下列預設 cache 項目沒有在電腦組態檔或根目錄 Web.config 檔中明確設定,但它卻是 .NET Framework 2.0 版中應用程式所傳回的預設組態。

<cache disableMemoryCollection="false" 
  disableExpiration="false" privateBytesLimit="0" 
  percentagePhysicalMemoryUsedLimit="90" 
  privateBytesPollTime="00:02:00" />

範例

下列範例設定 ASP.NET 應用程式的全域快取設定。

<cache disableMemoryCollection = "false" 
  disableExpiration = "false" 
  privateBytesLimit = "20971520" 
  percentagePhysicalMemoryUsedLimit = 60" 
  privateBytesPollTime = "00:01:00"/>

項目資訊

組態區段處理常式

System.Web.Configuration.CacheSection

組態成員

Cache

可設定的位置

Machine.config

根層次 Web.config

應用程式層級 Web.config

需求

IIS 5.0、5.1 和 6.0 版

.NET Framework 2.0 版

Visual Studio 2005

請參閱

工作

HOW TO:使用位置設定設定特定的目錄

HOW TO:鎖定 ASP.NET 組態設定

概念

ASP.NET 的快取組態

ASP.NET 快取概觀

ASP.NET 組態檔階層架構和繼承

保護 ASP.NET 組態

ASP.NET 組態案例

參考

system.web 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

caching 的 cache 項目 (ASP.NET 設定結構描述)

System.Configuration

System.Web.Configuration

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

管理 ASP.NET 網站

ASP.NET 組態檔

ASP.NET 組態 API