<memoryCache> 元素(缓存设置)

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

configuration
  <system.runtime.caching>
    <memoryCache>

语法

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

类型

MemoryCache 类。

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 说明
CacheMemoryLimitMegabytes MemoryCache 对象的实例可以增长到的最大内存大小(以兆字节为单位)。 默认值为 0,这意味着默认情况下使用 MemoryCache 类的自动调整大小启发。
Name 缓存配置的名称。
PhysicalMemoryLimitPercentage 缓存可以使用的物理内存的百分比。 默认值为 0,这意味着默认情况下使用 MemoryCache 类的自动调整大小启发。
PollingInterval 一个时间间隔的值,在该时间间隔之后,缓存实现会将当前内存负载与为缓存实例设置的基于绝对值和百分比的内存限制进行比较。 该值以“HH:MM:SS”格式输入。

子元素

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

父元素

元素 说明
<configuration> 指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
<system.runtime.caching> 包含使你可以在内置到 .NET Framework 中的应用程序中实现输出缓存的类型。

备注

MemoryCache 类是抽象 ObjectCache 类的具体实现。 MemoryCache 类的实例可以随来自应用程序配置文件的配置信息一起提供。 memoryCache 配置节包含 namedCaches 配置集合。

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

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

示例

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

cacheMemoryLimitMegabytes 属性和 physicalMemoryLimitPercentage 属性设置为零。 将这些特性设置为零意味着默认情况下使用 MemoryCache 自动调整大小试探法。 每隔两分钟,缓存实现应对当前内存负载和基于百分比的绝对内存限制进行比较。

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

另请参阅