啟用 Windows Server AppFabric 本機快取 (XML)

Windows Server AppFabric 可讓您以程式設計方式來設定快取用戶端，也可以讓您使用應用程式組態檔來設定快取用戶端。此主題中的程序說明當您使用 XML 型應用程式組態檔時，應如何在快取用戶端上啟用本機快取。如需以程式設計方式執行此動作的詳細資訊，請參閱啟用 Windows Server AppFabric 本機快取。

在應用程式組態檔中，本機快取設定是在 localCache 元素 (dataCacheClient 元素的子系) 中定義。localCache 元素中的 isEnabled 屬性決定是否啟用本機快取。或者，若組態檔中沒有 localCache 元素，或該元素已被加上特定字元而變成註解，則會停用本機快取功能。如需應用程式組態設定的詳細資訊，請參閱應用程式組態設定 (Windows Server AppFabric 快取)。

這些程序假設您已經準備好開發環境，並已設定對 AppFabric 快取組件的參考等。如需詳細資訊，請參閱準備快取用戶端開發環境 (Windows Server AppFabric 快取)。

使用應用程式組態檔啟用本機快取

1. 建立名為 App.config 的應用程式組態檔，然後將它新增至您的專案。如需詳細資訊，請參閱開始使用 Windows Server AppFabric 快取用戶端 (XML)。

2. 新增 localCache 元素以做為 dataCacheClient 元素的子系。

3. 將 localCache 元素的 isEnabled 屬性設定為 true 以啟用本機快取。

4. 設定 localCache 元素中的 sync 屬性。將此屬性設為 TimeoutBased 可使用逾時做為本機快取的無效判定方式。使用 NotificationBased 可另外使用快取通知做為本機快取的無效判定方式。NotificationsBased 選項需要您在具名快取上啟用快取通知。如需詳細資訊，請參閱快取通知 (Windows Server AppFabric 快取)。

5. 將 localCache 元素中的 ttlValue 屬性設為想要將物件保留在本機快取中的秒數。預設值為 300 秒。如需詳細資訊，請參閱到期與收回 (Windows Server AppFabric 快取)。

6. 或者，您可以設定 localCache 元素中的 objectCount 屬性，以指定本機快取物件的數目上限。預設值為 10,000 個物件。此閾值會觸發快取用戶端開始將最近最少使用的本機快取物件的 20% 移出記憶體。

7. 或者，如果您正在使用快取通知，並希望指定不同於預設值 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 快取功能。

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