共用方式為


開始使用 Windows Server AppFabric 快取用戶端 (XML)

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

如需應用程式組態設定的詳細資訊,請參閱應用程式組態設定 (Windows Server AppFabric 快取)

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

使用應用程式組態檔來設定快取用戶端

  1. 從 Visual Studio 的 [專案] 功能表,選取 [加入新項目]。

  2. 選取 [應用程式組態檔],將檔案命名為 App.config,然後按一下 [加入]。

  3. 將下一節的 XML 範例貼到您的 App.config 檔案的 <configuration> 標記內。 您的應用程式可能會將應用程式組態檔用於其他用途,但請確定 configSections 元素是 configuration 標記下的第一個元素。

  4. 視您的環境而定,更新或新增快取主機的 host 元素。 為每個:

    • 使用 name 屬性來指定每部主機的電腦名稱。

    • 使用 cachePort 屬性來指定主機的快取連接埠號碼。

  5. 在您的程式碼中,使用預設的建構函式建立 DataCacheFactory 物件。 若未將組態參數傳遞給 DataCacheFactory 物件,您的應用程式會使用 App.config 檔案中的組態設定。

  6. 若要開始使用快取用戶端,請使用 GetCache 方法來建立 DataCache 物件。

範例

此範例應用程式組態檔設定為指向兩部伺服器,亦即 CacheServer1CacheServer2。 請使用您的快取伺服器名稱來取代此範例中的伺服器名稱。 視情況新增或移除主機標記以配合您的環境。

理想的做法是指定已指定為主要主機的快取主機。 主要主機通常是在叢集中安裝的第一部快取伺服器。 如需有關主要主機的詳細資訊,請參閱 Windows Server AppFabric 快取功能實體架構圖

您可以使用 Windows PowerShell 管理工具來判斷哪些主機是主要主機。 如需有關 Windows PowerShell 的詳細資訊,請參閱使用 Windows PowerShell 來管理 Windows Server AppFabric 快取功能

注意

Visual Basic 可能會先自動新增元素到您的應用程式組態檔。 AppFabric 的快取功能不需要那些額外的元素,如果您的應用程式在其他方面不需要這些元素,可以將它們刪除。

<?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>
      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

在應用程式組態檔中指定快取用戶端組態設定之後,開始設計可進行快取的應用程式。 此範例會使用預設建構函式建立名為 CacheFactory1DataCacheFactory 物件。 因為快取用戶端組態設定不會傳遞給 DataCacheFactory 建構函式的第一個參數,快取用戶端將設定為使用應用程式組態檔中指定的設定。

注意

基於效能考量,我們建議您將使用可進行快取的應用程式建立之 DataCacheFactory 物件數目最小化。 在變數中儲存 DataCacheFactory 物件,以供使用快取用戶端之應用程式的所有組件使用。

接著,使用 GetCache 方法來建立名為 myCache1DataCache 物件。 然後呼叫 Add 方法,以將物件新增至快取。

' Use configuration from the application configuration file.
Dim CacheFactory1 As DataCacheFactory = New DataCacheFactory()

' Get cache client for cache "NamedCache1".
Dim myCache1 As DataCache = CacheFactory1.GetCache("NamedCache1")

' Add an object to the cache.
myCache1.Add("helloKey", "hello world")
// Use configuration from the application configuration file.
DataCacheFactory CacheFactory1 = new DataCacheFactory();

// Get cache client for cache "NamedCache1".
DataCache myCache1 = CacheFactory1.GetCache("NamedCache1");

// Add an object to the cache.
myCache1.Add("helloKey", "hello world");

另請參閱

概念

開始使用 Windows Server AppFabric 快取用戶端 (XML)
啟用 Windows Server AppFabric 本機快取 (XML)
設定 ASP.NET 工作階段狀態提供者 (Windows Server AppFabric 快取)
快取用戶端與本機快取 (Windows Server AppFabric 快取)
使用組態方式 (Windows Server AppFabric 快取)
Windows Server AppFabric 快取概念
開發快取用戶端 (Windows Server AppFabric 快取)

  2011-12-05