启用 Windows Server AppFabric 本地缓存 (XML)

项目
12/05/2011

Windows Server AppFabric 提供了以编程方式或使用应用程序配置文件配置缓存客户端的选项。本主题中的过程介绍了在使用基于 XML 的应用程序配置文件时如何在缓存客户端上启用本地缓存。有关如何以编程方式执行此操作的信息，请参阅启用 Windows Server AppFabric 本地缓存。

在应用程序配置文件中，本地缓存设置在 localCache 元素中定义，它是 dataCacheClient 元素的子元素。localCache 元素中的 isEnabled 属性决定了是否启用本地缓存。另外，localCache 元素可能丢失（或注释掉）以表示其已禁用。有关应用程序配置设置的详细信息，请参阅应用程序配置设置（Windows Server AppFabric 缓存）。

这些过程假设您已经准备好了开发环境并设置了对 AppFabric 缓存程序集的引用等内容。有关详细信息，请参阅准备缓存客户端开发环境（Windows Server AppFabric 缓存）。

使用应用程序配置文件启用本地缓存

创建一个名为 App.config 的应用程序配置文件，然后将其添加到项目中。有关详细信息，请参阅Windows Server AppFabric 缓存客户端 (XML) 入门。
添加 localCache 元素作为 dataCacheClient 元素的子元素。
将 localCache 元素的 isEnabled 属性设置为 true，以启用本地缓存。
设置 localCache 元素中的 sync 属性。将此属性设置为 TimeoutBased，以使用超时来使本地缓存失效。使用 NotificationBased 以再次使用缓存通知来使本地缓存失效。NotificationsBased 选项需要在命名缓存上启用缓存通知。有关详细信息，请参阅缓存通知（Windows Server AppFabric 缓存）。
在 localCache 元素中设置 ttlValue 属性，使其等于希望对象在本地缓存中保留的秒数。300 秒为默认值。有关详细信息，请参阅过期和逐出（Windows Server AppFabric 缓存）。
或者，设置 localCache 元素中的 objectCount 属性，以指定本地缓存对象的最大数量。默认值为 10,000 个对象。此阈值将触发缓存客户端，以开始移出 20% 最近较少使用的本地缓存对象。
或者，如果您正在使用缓存通知并且希望指定不同于 300 秒这一默认值的轮询间隔，则添加 clientNotification 元素作为 dataCacheClient 元素的子元素。使用 clientNotification 元素的 pollInterval 属性来指定具体的轮询间隔值。此元素和属性可用于为缓存通知指定轮询间隔（即使您不想使用本地缓存）。

示例

本示例演示当启用了本地缓存时本地缓存元素的外观。应将此元素添加到 dataCacheClient 元素中。

XML

<!-- local cache enabled -->
<localCache
  isEnabled="true"
  sync="TimeoutBased"
  objectCount="100000"
  ttlValue="300" />

本示例应用程序配置文件启用了本地缓存，并配置为指向一个缓存服务器，即，CacheServer1。要使用本示例，将本示例中的服务器名称替换成您的缓存服务器名称。根据需要添加或删除主机标签以适应您的环境。

最好指定那些曾被指定为主要主机的缓存主机。主要主机通常是群集中安装的首批缓存服务器。有关主要主机的详细信息，请参阅 Windows Server AppFabric 缓存物理体系结构示意图。您可以使用 Windows PowerShell 管理工具确定哪些主机是主要主机。有关 Windows PowerShell 的详细信息，请参阅使用 Windows PowerShell 管理 Windows Server AppFabric 缓存功能。

备注

Visual Basic 首先会自动向您的应用程序配置文件中添加元素。AppFabric 的缓存功能不需要这些额外元素，如果应用程序不需要它们，可以将其删除。

XML

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <!--configSections must be the FIRST element -->
   <configSections>
      <!-- required to read the <dataCacheClient> element -->
      <section name="dataCacheClient"
         type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
            Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, 
            Culture=neutral, PublicKeyToken=31bf3856ad364e35"
         allowLocation="true"
         allowDefinition="Everywhere"/>
   </configSections>

   <dataCacheClient>
      <!-- (optional) specify local cache -->
      <localCache
         isEnabled="true"
         sync="TimeoutBased"
         objectCount="100000"
         ttlValue="300" />

      <!--(optional) specify cache notifications poll interval
      <clientNotification pollInterval="300" /> -->

      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

另请参阅

概念

Windows Server AppFabric 缓存客户端 (XML) 入门
 配置 ASP.NET 会话状态提供程序（Windows Server AppFabric 缓存）
缓存客户端和本地缓存（Windows Server AppFabric 缓存）
使用配置方法（Windows Server AppFabric 缓存）
Windows Server AppFabric 缓存概念
 开发缓存客户端（Windows Server AppFabric 缓存）

2011-12-05

通过

启用 Windows Server AppFabric 本地缓存 (XML)

使用应用程序配置文件启用本地缓存

示例

另请参阅

概念

其他资源