<namedCaches> 元素（缓存设置）

  • 项目

包含命名的 MemoryCache 实例的配置设置的集合。 属性 NamedCaches 引用配置文件的一个或多个 namedCaches 元素的配置设置集合。

configuration
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

语法

<namedCaches>  
  <add name="Default"/>
</namedCaches>

类型

None

特性和元素

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

特性

属性 说明
cacheMemoryLimitMegabytes 一个整数值，指定 MemoryCache 实例可以增长到的最大允许大小（以兆字节为单位）。 默认值为 0，这意味着默认情况下使用 MemoryCache 类的自动调整大小试探法。
name 缓存的名称。
physicalMemoryLimitPercentage 一个介于 0 和 100 之间的整数值，指定缓存可以使用的物理安装计算机内存的最大百分比。 默认值为 0，这意味着默认情况下使用 MemoryCache 类的自动调整大小试探法。
pollingInterval 一个时间间隔的值，在该时间间隔之后，缓存实现会将当前内存负载与为缓存实例设置的基于绝对值和百分比的内存限制进行比较。 该值以“HH:MM:SS”格式输入。

子元素

元素 说明
<add> 向内存缓存的 namedCaches 集合添加一个命名的缓存。
<clear> 清除内存缓存的 namedCaches 集合。
<remove> 从内存缓存的 namedCaches 集合中删除一个命名的缓存条目。

父元素

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

备注

Web.config 文件的内存缓存配置可包含 namedCaches 集合的 add、remove 和 clear 属性。 每个 namedCaches 条目都由 name 属性唯一标识。

可以通过引用应用程序配置文件中的信息来检索内存缓存项的实例。 默认情况下，只有默认缓存实例在配置文件中具有条目。 默认缓存实例是从 Default 属性返回的实例。

如果将 name 属性设置为“Default”，则元素使用默认内存缓存实例。

示例

下面的示例演示如何通过将 name 属性设置为“default”，来将缓存名称设置为默认缓存条目名称。

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

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

请参阅