共用方式為

Windows Server AppFabric 快取 API 使用範例

  • 發行項

此範例顯示如何使用各種 AppFabric 快取 API。

注意

提供的範例僅適用於教學用途。請勿將範例用於生產環境，因為這些範例並未在生產環境中測試。Microsoft 不對這些範例提供技術支援。

必要條件

使用者最好具備 Windows PowerShell 指令碼的知識。

此範例假設下列各項：

  • 已安裝 Windows PowerShell 2.0。

  • 已安裝 Windows Server AppFabric (這樣也會將必要的 DLL 新增到 GAC)。

設定 AppFabric 快取

如果您尚未設定 AppFabric 快取，請使用 Windows Server AppFabric 組態工具 (使用預設設定) 來設定。本範例假設您已使用預設設定來設定 AppFabric 快取 (cacheHostName=AppFabricCachingService 且 cacheName=default)。

啟動快取叢集

  1. 以提升的權限開啟 Windows PowerShell 命令視窗，並執行下列命令以新增「分散式快取」管理模組：

    Import-Module DistributedCacheAdministration

  2. 使用 Use-CacheCluster 命令，將 Windows PowerShell 工作階段的內容設定至想要的快取叢集。您可以不使用參數來執行此動作，這樣會使用設定 AppFabric 快取管理元件時提供的連接參數。

  3. 執行下列命令，將以用戶端方式存取快取叢集的權限授與使用者帳戶。提供您的使用者與網域名稱。

    Grant-CacheAllowedClientAccount domain\username

  4. 使用 Get-CacheAllowedClientAccounts 命令確認已將權限授與您的使用者帳戶。

  5. 使用 Start-CacheCluster 命令啟動叢集。

建置並執行此範例

  1. 在 Visual Studio 中開啟 CacheAPI.sln 方案檔案。此範例會自動從 GAC 連結到 AppFabric 快取 DLL (Microsoft.ApplicationServer.Caching.Client.dll 與 Microsoft.ApplicationServer.Caching.Core.dll)。此範例示範下列使用模式：

    • 移除/建立具名區域

    • 對預設的快取/區域執行簡單的 Add/Get

    • 對預設快取中的具名區域執行 Add/Get

    • 對具名區域執行 Add/Get/GetAndLock/GetIfNewer/Put/PutAndUnlock。變化：

      • GetAndLock 嘗試存取鎖定的物件

      • PutAndUnlock 嘗試解除鎖定未鎖定的物件

    • 對已建立版本的物件執行 Add/Get/Put

      • 只在版本相符時明確修改項目

      • 如果快取中有較新的項目，則無法修改項目。

    • 執行簡單的 Add/GetByTag 以顯示標記用法

    注意

    之後每次執行此範例時，請使用 Restart-CacheCluster 命令清除快取，然後等候 10-15 秒。

移除此範例

使用 Restart-CacheCluster 命令重新啟動快取叢集以清除快取中的資料。

另請參閱

其他資源

Windows Server AppFabric 快取範例

  2011-12-05