指定命名 MemoryCache 实例的配置设置集合。 该 NamedCaches 属性引用配置文件的一个或多个 namedCaches 元素中的配置设置集合。
<配置>
<system.runtime.caching>
<memoryCache>
<namedCaches>
Syntax
<namedCaches>
<add name="Default"/>
</namedCaches>
类型
None
特性和元素
下列各节描述了特性、子元素和父元素。
特性
| Attribute | Description |
|---|---|
cacheMemoryLimitMegabytes |
一个整数值，该值指定一个 MemoryCache 实例可以增长到的最大允许大小（以兆字节为单位）。 默认值为 0，这意味着默认使用类的 MemoryCache 自动调整启发式。 |
name |
缓存的名称。 |
physicalMemoryLimitPercentage |
一个介于 0 和 100 之间的整数值，该值指定缓存可以使用的物理安装计算机内存的最大百分比。 默认值为 0，这意味着默认使用类的 MemoryCache 自动调整启发式。 |
pollingInterval |
一个值，该值指示缓存实现将当前内存负载与为缓存实例设置的基于绝对和百分比的内存限制进行比较的时间间隔。 此值以“HH：MM：SS”格式输入。 |
子元素
| 元素 | Description |
|---|---|
| <加> | 将命名缓存添加到内存缓存的 namedCaches 集合中。 |
| <清楚> | 清除内存缓存的 namedCaches 集合。 |
| <删除> | 从内存缓存的 namedCaches 集合中删除命名缓存项。 |
父元素
| 元素 | Description |
|---|---|
| <配置> | 指定公共语言运行时和 .NET Framework 应用程序使用的每个配置文件中的根元素。 |
| <memoryCache> | 定义用于配置基于类的缓存的 MemoryCache 元素。 |
| <system.runtime.caching> | 包含用于在 .NET Framework 中内置的应用程序中实现输出缓存的类型。 |
注解
Web.config 文件的内存缓存配置部分可以包含addremove集合的属性和clear属性namedCaches。 每个 namedCaches 条目都由 name 特性唯一标识。
可以通过引用应用程序配置文件中的信息来检索内存缓存条目的实例。 默认情况下，只有默认缓存实例在配置文件中具有一个条目。 默认缓存实例是从属性返回的 Default 实例。
如果将 name 属性设置为“Default”，则元素将使用默认内存缓存实例。
Example
以下示例演示如何通过将 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>
