为 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" /> |
属性和元素
以下几节描述了属性、子元素和父元素。
属性
属性 | 说明 |
---|---|
disableMemoryCollection |
可选的 Boolean 属性。 获取或设置一个值,该值指示是否当计算机处于内存压力下时是否禁止执行缓存内存回收。 |
disableExpiration |
可选的 Boolean 属性。 获取或设置一个值,该值指示是否禁用缓存过期。如果禁用,则缓存项不会过期,并且不会对过期缓存项执行后台清理。 |
privateBytesLimit |
可选的 Int64 属性。 获取或设置一个值,该值指示在缓存开始刷新过期项并尝试回收内存之前应用程序的最大专用字节大小。此限制同时包括缓存所使用的内存量以及运行应用程序的正常内存开销。如果设置为零,则指示 ASP.NET 将使用自己的试探法确定何时开始回收内存。 |
percentagePhysicalMemoryUsedLimit |
可选的 Int32 属性。 获取或设置一个值,该值指示在缓存开始刷新过期项并尝试回收内存之前应用程序可使用的最大计算机物理内存百分比。该内存使用率同时包括缓存使用的内存以及正运行的应用程序的正常内存使用率。如果设置为零,则指示 ASP.NET 将使用自己的试探法确定何时开始回收内存。 |
privateBytesPollTime |
可选的 TimeSpan 属性。 获取或设置一个值,该值指示两次轮询应用程序专用字节内存使用量之间的时间间隔。 |
子元素
无。
父元素
元素 | 说明 |
---|---|
configuration |
公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素。包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
caching |
为 Web 应用程序配置缓存设置。 |
备注
默认配置
下面的默认 cache 元素不是在计算机配置文件或根 Web.config 文件中显式配置的,而是由 .NET Framework 版本 2.0 中的应用程序返回的默认配置。
? | ![]() |
---|---|
<cache disableMemoryCollection = "false" disableExpiration = "false" privateBytesLimit = "0" percentagePhysicalMemoryUsedLimit = "89" privateBytesPollTime = "00:02:00" /> <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"/> |
元素信息
Configuration Section Handler |
|
Configuration Member |
|
Configurable Locations |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config |
Requirements |
IIS 版本 5.0、5.1 和 6.0 .NET Framework 版本 2.0 Visual Studio 2005 |
请参见
任务
参考
system.web 元素(ASP.NET 设置架构)configuration 元素(常规设置架构)
caching 的 cache 元素(ASP.NET 设置架构)
概念
其他资源
常规配置设置 (ASP.NET)ASP.NET 配置设置
