AppFabric キャッシュ API 使用例
このサンプルは、さまざまな AppFabric キャッシュ API の使用方法を示しています。
ヒント
サンプルは学習用としてのみ提供されています。運用環境での使用を目的としておらず、運用環境でのテストも行われていません。サンプルについてマイクロソフトのテクニカル サポートは提供されません。
前提条件
ユーザーに Windows PowerShell スクリプトの知識があれば理想的です。
サンプルでは次のことを前提としています。
Windows PowerShell 2.0 がインストールされている。
Microsoft AppFabric 1.1 for Windows Server がインストールされている (このインストールにより、必要な DLL も GAC に追加されます)。
AppFabric キャッシュの構成
AppFabric キャッシュをまだ構成していない場合は、Microsoft AppFabric 1.1 for Windows Server 構成ツールを使用して構成します (既定の設定を使用します)。サンプルでは、AppFabric キャッシュが既定の設定 (cacheHostName=AppFabricCachingService および cacheName=default) で構成されていることを前提としています。
キャッシュ クラスターの開始
Windows PowerShell コマンド ウィンドウを管理者モードで開き、次のコマンドを実行して分散キャッシュ管理モジュールを追加します。
Import-Module DistributedCacheAdministration
Use-CacheCluster コマンドを使用して、Windows PowerShell セッションのコンテキストを目的のキャッシュ クラスターに設定します。このコマンドをパラメーターなしで実行すると、AppFabric キャッシュ管理コンポーネントの構成時に指定した接続パラメーターを使用することができます。
次のコマンドを実行して、キャッシュ クラスターへのクライアントとしてのアクセス権をユーザー アカウントに付与します。ユーザーおよびドメイン名を指定します。
Grant-CacheAllowedClientAccount domain\username
Get-CacheAllowedClientAccounts コマンドを使用して、ユーザー アカウントにアクセス権が付与されたことを確認します。
Start-CacheCluster コマンドを使用してクラスターを開始します。
このサンプルのビルドおよび実行
Visual Studio で CacheAPI.sln ソリューション ファイルを開きます。サンプルは、GAC から自動的に AppFabric キャッシュ DLL (Microsoft.ApplicationServer.Caching.Client.dll および Microsoft.ApplicationServer.Caching.Core.dll) にリンクされます。サンプルは次の利用パターンを示しています。
名前付き領域の Remove/Create
既定のキャッシュまたは領域に対する単純な Add/Get
既定のキャッシュ内の名前付き領域に対する Add/Get
名前付き領域に対する Add/Get/GetAndLock/GetIfNewer/Put/PutAndUnlock。バリエーション:
ロックされたオブジェクトにアクセスしようとする GetAndLock
ロックされていないオブジェクトをロック解除しようとする PutAndUnlock
バージョン管理されているオブジェクトの Add/Get/Put
バージョンが一致する場合にのみアイテムを明示的に変更する
新しいアイテムがキャッシュにある場合、アイテムの変更は失敗する
タグの使用方法を表示する単純な Add/GetByTag
ヒント
その後、このサンプルを実行するには、その都度 Restart-CacheCluster コマンドを使用してキャッシュをクリアし、10 ~ 15 秒間待機します。
このサンプルの削除
Restart-CacheCluster コマンドを使用してキャッシュ クラスターを再起動し、キャッシュからデータをクリアします。
関連項目
その他のリソース
2012-03-05