<memoryCache> 元素 (缓存设置)

定义用于配置基于类的缓存的 MemoryCache 元素。 该 MemoryCacheElement 类定义可用于配置缓存的 memoryCache 元素。 可以在单个应用程序中使用类的 MemoryCache 多个实例。 memoryCache配置文件中的每个元素都可以包含命名MemoryCache实例的设置。

<配置>
   <system.runtime.caching>
     <memoryCache>

语法

<memoryCache>
    <namedCaches>  
        <!-- child elements -->  
    </namedCaches>
</memoryCache>  

类型

MemoryCache 类。

属性和元素

以下部分介绍属性、子元素和父元素。

特性

特征 DESCRIPTION
CacheMemoryLimitMegabytes 对象实例 MemoryCache 可以增长到的最大内存大小(以兆字节为单位)。 默认值为 0,这意味着 MemoryCache 默认情况下使用类的自动大小启发式。 (此设置仅在 .Net Framework 上有效。
Name 缓存配置的名称。
PhysicalMemoryLimitPercentage 系统(由所有进程)上的总物理内存使用量百分比,缓存将开始逐出条目。 默认值为 0,这意味着 MemoryCache 默认情况下使用类的自动大小启发式。
PollingInterval 一个值,该值指示缓存实现将当前内存负载与为缓存实例设置的基于绝对和百分比的内存限制进行比较的时间间隔。 该值以“HH:MM:SS”格式输入。

子元素

元素 DESCRIPTION
<namedCaches> 包含实例的配置设置 namedCache 集合。

父元素

元素 DESCRIPTION
<配置> 指定公共语言运行时和 .NET Framework 应用程序使用的每个配置文件中的根元素。
<system.runtime.caching> 包含用于在 .NET Framework 中内置的应用程序中实现输出缓存的类型。

注解

MemoryCache 类是抽象 ObjectCache 类的具体实现。 可以使用应用程序配置文件中的配置信息提供类的 MemoryCache 实例。 memoryCache 配置部分包含配置namedCaches集合。

初始化基于内存的缓存对象时,它首先尝试查找 namedCaches 与传递给内存缓存构造函数的参数中的名称匹配的条目。 namedCaches如果找到条目,将从配置文件中检索轮询和内存管理信息。

然后,初始化过程通过使用构造函数中配置信息的名称/值对的可选集合来确定是否重写了任何配置条目。 如果在名称/值对集合中传递以下任一值,则这些值将替代从配置文件获取的信息:

示例:

以下示例演示如何通过将属性设置为name“Default”,将对象的名称MemoryCache设置为默认缓存对象名称。

属性 cacheMemoryLimitMegabytesphysicalMemoryLimitPercentage 特性设置为零。 将这些属性设置为零意味着 MemoryCache 默认使用自动调整启发式。 缓存实现应每隔两分钟将当前内存负载与基于绝对和百分比的内存限制进行比较。

<configuration>  
  <system.runtime.caching>  
    <memoryCache>  
      <namedCaches>  
          <add name="Default"
               cacheMemoryLimitMegabytes="0"
               physicalMemoryLimitPercentage="0"  
               pollingInterval="00:02:00" />  
      </namedCaches>  
    </memoryCache>  
  </system.runtime.caching>  
</configuration>  

另请参阅