Share via


caching 的 cache 元素(ASP.NET 设置架构)

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

为 ASP.NET Web 应用程序定义应用程序范围的缓存设置。

<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

请参见

任务

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

参考

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

caching 的 cache 元素(ASP.NET 设置架构)

System.Configuration

System.Web.Configuration

概念

Cache Configuration in ASP.NET

ASP.NET Caching Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API