应用程序配置设置（Windows Server AppFabric 缓存）

  • 项目

使用 Windows Server AppFabric 的缓存功能，您可以通过使用应用程序配置文件或通过使用应用程序中不同位置上的方法，以编程方式配置应用程序的缓存客户端设置。有关按每个配置方法和如何选择的详细信息，请参阅客户端配置选项（Windows Server AppFabric 缓存）。

无论采用何种方法，均配置相同的缓存客户端设置。本主题中的表格显示缓存客户端可用的设置，并显示在基于 XML 的应用程序配置文件中的配置方法，以及以编程方式、通过使用节点的配置方法。

有关如何使用应用程序中的这些设置的详细信息，请参阅基于 XML 的客户端配置（Windows Server AppFabric 缓存）。

缓存客户端设置

设置 XML 配置位置 代码配置位置

客户端超时(毫秒)

dataCacheClient 元素中的 requestTimeout 属性。我们不建议指定小于 10000（10 秒）的值。默认值为 15000。

DataCacheFactoryConfiguration 类的 RequestTimeout 属性。

频道打开超时(毫秒)

dataCacheClient 元素中的 channelOpenTimeout 属性。可以将该值设置为 0 以便立即处理任何网络问题。有关详细信息，请参阅 配置缓存客户端超时（Windows Server AppFabric 缓存）。默认值为 3000。

DataCacheFactoryConfiguration 类的 ChannelOpenTimeout 属性。

与服务器的最大连接数

dataCacheClient 元素中的 maxConnectionsToServer 属性。默认值为 1。

DataCacheFactoryConfiguration 类的 MaxConnectionsToServer 属性。

缓存主机设置

对于每个缓存客户端，您必须指定群集中的一个或多个缓存主机。指定主要主机，因为将缓存主机指定为主要主机可帮助管理群集。主要主机是最初安装在群集中的首个缓存主机。有关主要主机的详细信息，请参阅 Windows Server AppFabric 缓存物理体系结构示意图。

在应用程序配置文件中，将在主机元素（hosts 元素的子元素）中指定每个缓存主机的设置。以编程方式来说，在 DataCacheServerEndpoint 类的类构造函数中会定义每个主机。对其进行实例化之后，这些 DataCacheServerEndPoint 对象随后将传递到 DataCacheServerEndpoint 类的 Servers 属性。

设置 XML 配置位置 代码配置位置

缓存服务器名称

host 元素的 name 属性。

DataCacheServerEndpoint 类的 HostName 属性。

缓存端口号

host 元素的 cachePort 属性。

DataCacheServerEndpoint 类的 CachePort 属性。

本地缓存设置

本地缓存设置指定是否应启用本地缓存，应使本地缓存对象失效的方式，对象超时以及缓存通知是否应该用于使本地缓存对象失效。

在应用程序配置文件中，本地缓存设置定义在 localCache 元素（dataCacheClient 元素的子）中。采用编程方式，将本地缓存配置为传递给 DataCacheFactory 类构造函数的构造函数的 DataCacheFactoryConfiguration 类的实例。有关本地缓存的详细信息，请参阅缓存客户端和本地缓存（Windows Server AppFabric 缓存）。

设置 XML 配置位置 代码配置位置

本地缓存已启用

localCache 元素中的 isEnabled 属性。值可以是 true 或 false。localCache 元素也可能缺失，以表明该元素已禁用。

DataCacheLocalCacheProperties 类的 IsEnabled 属性。然后，这将分配给 DataCacheFactoryConfiguration 类的 LocalCacheProperties 属性。

本地缓存失效方法

localCache 元素中的 sync 属性。TimeoutBased 值用于表明应使用超时值。NotificationBased 用于表明还应使用缓存通知。

DataCacheLocalCacheProperties 类的 InvalidationPolicy 属性。可能的值包括 NotificationBased 和 TimeoutBased。

本地缓存超时（秒）

localCache 元素中的 ttlValue 属性。

DataCacheLocalCacheProperties 类的 DefaultTimeout 属性。

指定缓存通知轮询时间间隔（秒）

（可选）由 clientNotification 元素的 pollInterval 属性指定。clientNotification 元素是 dataCacheClient 元素的子，而非 localCache 元素的子。如果未指定，则将使用值 300 秒。

DataCacheNotificationProperties 类的 PollInterval 属性。然后，这将分配给 DataCacheFactoryConfiguration 类的 NotificationProperties 属性。

本地缓存对象的最大计数

（可选）由 localCache 元素中的 objectCount 属性指定。本地缓存上应启动逐出时进行触发；然后它将尝试删除最近最少使用的 20% 的本地缓存对象。如果未指定，则使用默认值 10,000 个对象。

DataCacheLocalCacheProperties 类的 ObjectCount 属性。

备注

为获得最佳性能，仅启用较少更改的对象的本地缓存。使用经常更改数据的本地缓存可能增加客户端将使用过时对象的机会。虽然您可以降低 ttlValue，并且更频繁地刷新本地缓存，但群集上增加的负载可能超过使用本地缓存的优势。在经常更改数据的情况下，最好禁用本地缓存并从群集中直接提取数据。

通知设置

在应用程序配置文件中，通知属性是在 clientNotification 元素（dataCacheClient 元素的子元素）中定义的。采用编程方式，将通知属性配置为传递给 DataCacheFactory 类构造函数的构造函数的 DataCacheFactoryConfiguration 类的实例。有关详细信息，请参阅配置方法（Windows Server AppFabric 缓存）。

设置 XML 配置位置 代码配置位置

特定缓存通知轮询时间间隔(秒)

由 clientNotification 元素的 pollInterval 属性指定。如果未指定，则将使用值 300 秒。

DataCacheNotificationProperties 类的 PollInterval 属性。然后，这将分配给 DataCacheFactoryConfiguration 类的 NotificationProperties 属性。

最大队列长度

clientNotification 元素的 maxQueueLength 属性。如果未指定，则默认值为 10000。

DataCacheNotificationProperties 类的 MaxQueueLength 属性。

安全设置

在应用程序配置文件中，安全属性是在 securityProperties 元素（dataCacheClient 元素的子元素）中定义的。采用编程方式，将安全属性配置为传递给 DataCacheFactory 类构造函数的构造函数的 DataCacheFactoryConfiguration 类的实例。有关详细信息，请参阅配置方法（Windows Server AppFabric 缓存）。

设置 XML 配置位置 代码配置位置

模式

securityProperties 元素的 mode 属性。可能的值包括 Transport 和 None。默认值为 Transport。

DataCacheSecurity 类的 SecurityMode 属性。可能的值包括 None 和 Transport。然后，将 DataCacheSecurity 对象分配给 DataCacheFactoryConfiguration 类的 SecurityProperties 属性。

保护级别

securityProperties 元素的 protectionLevel 属性。可能的值包括 None、Sign 和 EncryptAndSign。默认值为 EncryptAndSign。

DataCacheSecurity 类的 ProtectionLevel 属性。可能的值包括 None、Sign 和 EncryptAndSign。

传输设置

在应用程序配置文件中，传输属性是在 transportProperties 元素（dataCacheClient 元素的子元素）中定义的。采用编程方式，将传输属性配置为传递给 DataCacheFactory 类构造函数的构造函数的 DataCacheFactoryConfiguration 类的实例。有关详细信息，请参阅配置方法（Windows Server AppFabric 缓存）。

设置 XML 配置位置 代码配置位置

连接缓冲区大小(字节)

transportProperties 元素的 connectionBufferSize 属性。

DataCacheTransportProperties 类的 ConnectionBufferSize 属性。然后，这将分配给 DataCacheFactoryConfiguration 类的 TransportProperties 属性。

最大缓冲区池大小(字节)

transportProperties 元素的 maxBufferPoolSize 属性。

DataCacheTransportProperties 类的 MaxBufferPoolSize 属性。

最大缓冲区大小(字节)

transportProperties 元素的 maxBufferSize 属性。

DataCacheTransportProperties 类的 MaxBufferSize 属性。

最大输出延迟(毫秒)

transportProperties 元素的 maxOutputDelay 属性。

DataCacheTransportProperties 类的 MaxOutputDelay 属性。

通道初始化超时(毫秒)

transportProperties 元素的 channelInitializationTimeout 属性。

DataCacheTransportProperties 类的 ChannelInitializationTimeout 属性。

接收超时(毫秒)

transportProperties 元素的 receiveTimeout 属性。

DataCacheTransportProperties 类的 ReceiveTimeout 属性。

示例应用程序配置文件

为使 AppFabric 程序集读取应用程序配置文件中的 XML 元素，必须包含 configSections 元素，作为 configuration 标记下文件中的首个元素。在 configSections 元素中，必须包含一个与 dataCacheClient 元素相关联的 section 元素。

以下示例显示一个应用程序配置文件，该文件使用本主题中介绍的许多缓存客户端配置选项。请注意，只需将 dataCacheClient 中的 hosts 元素连接到群集。其他所有子元素都具有默认值。

<?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 requestTimeout="15000" channelOpenTimeout="3000" maxConnectionsToServer="1">
      <localCache isEnabled="true" sync="TimeoutBased" ttlValue="300" objectCount="10000"/>
      <clientNotification pollInterval="300" maxQueueLength="10000"/>
      <hosts>
         <host name="CacheServer1" cachePort="22233"/>
         <host name="CacheServer2" cachePort="22233"/>
      </hosts>
      <securityProperties mode="Transport" protectionLevel="EncryptAndSign" />
      <transportProperties connectionBufferSize="131072" maxBufferPoolSize="268435456" 
                           maxBufferSize="8388608" maxOutputDelay="2" channelInitializationTimeout="60000" 
                           receiveTimeout="600000"/>
   </dataCacheClient>
</configuration>

另请参阅

概念

客户端配置选项（Windows Server AppFabric 缓存）
群集配置设置（Windows Server AppFabric 缓存）
Windows Server AppFabric 缓存问题疑难解答
使用 Windows PowerShell 管理 Windows Server AppFabric 缓存功能
Windows Server AppFabric 缓存概念
开发缓存客户端（Windows Server AppFabric 缓存）

  2011-12-05