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

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性

说明

disableMemoryCollection

可选的 Boolean 属性。

获取或设置一个值,该值指示是否当计算机处于内存压力下时是否禁止执行缓存内存回收。

disableExpiration

可选的 Boolean 属性。

获取或设置一个值,该值指示是否禁用缓存过期。如果禁用,则缓存项不会过期,并且不会对过期缓存项执行后台清理。

privateBytesLimit

可选的 Int64 属性。

获取或设置一个值,该值指示在缓存开始刷新过期项并尝试回收内存之前应用程序的最大专用字节大小。此限制同时包括缓存所使用的内存量以及运行应用程序的正常内存开销。如果设置为零,则指示 ASP.NET 将使用自己的试探法确定何时开始回收内存。

percentagePhysicalMemoryUsedLimit

可选的 Int32 属性。

获取或设置一个值,该值指示在缓存开始刷新项并尝试回收内存之前可使用的计算机的物理内存的最大百分比。请注意,此限制适用于使用中的总物理内存。设置为 0 会导致在插入项后立即将其移除。

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

请参见

任务

如何:使用位置设置配置特定目录

如何:锁定 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