開始使用快取用戶端 (XML)

發行項
03/05/2012

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

如需應用程式組態設定的詳細資訊，請參閱應用程式組態設定 (AppFabric 1.1 快取)。

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

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

從 Visual Studio 的 [專案] 功能表，選取 [加入新項目]。
選取 [應用程式組態檔]，將檔案命名為 App.config，然後按一下 [加入]。
將下一節的 XML 範例貼到您的 App.config 檔案的 <configuration> 標記內。您的應用程式可能會將應用程式組態檔用於其他用途，但請確定 configSections 元素是 configuration 標記下的第一個元素。
視您的環境而定，更新或新增快取主機的 host 元素。為每個：
- 使用 name 屬性來指定每部主機的電腦名稱。
- 使用 cachePort 屬性來指定主機的快取連接埠號碼。
在您的程式碼中，使用預設的建構函式建立 DataCacheFactory 物件。若未將組態參數傳遞給 DataCacheFactory 物件，您的應用程式會使用 App.config 檔案中的組態設定。
若要開始使用快取用戶端，請使用 GetCache 方法來建立 DataCache 物件。

範例

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

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

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

注意

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>

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

注意

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

接著，使用 GetCache 方法來建立名為 myCache1 的 DataCache 物件。然後呼叫 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");

另請參閱

概念

啟用本機快取 (XML)
快取用戶端與本機快取 (AppFabric 1.1 快取)
使用組態方式
 AppFabric 快取概念 (AppFabric 1.1 快取)
開發快取用戶端

其他資源

作法：開始使用路由用戶端 (XML)
作法：設定工作階段狀態提供者 (XML)

2012-03-05

共用方式為

開始使用快取用戶端 (XML)

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

範例

另請參閱

概念

其他資源

其他資源