キャッシュクライアント開発環境の準備 (Windows Server AppFabric キャッシュ)

[アーティクル]
12/05/2011

このトピックでは、キャッシュが有効なアプリケーションの開発を開始できるように Visual Studio プロジェクトを準備する方法について説明します。以下の手順では、Windows Server AppFabric を既にインストール済みであり、1 台以上のキャッシュサーバーに、または開発ワークステーションに AppFabric キャッシュ機能を構成済みであると想定しています。詳細については、『Windows Server AppFabric インストールガイド』 (https://go.microsoft.com/fwlink/?LinkId=169172) を参照してください。

AppFabric キャッシュ機能をインストールする以外にも、キャッシュクライアントからキャッシュにアクセスできるようにするために、以下の手順を実行する必要があります。

Windows PowerShell で、Use-CacheCluster を使用してコンテキストをターゲットキャッシュクラスターに設定します。
New-Cache コマンドを使用して必要な名前付きキャッシュを作成します。
Grant-CacheAllowedClientAccount コマンドを使用して、キャッシュクライアントの Windows アカウントにアクセス権を付与します。
Start-CacheCluster コマンドを使用してキャッシュクラスターを起動します。

Windows PowerShell およびここに示したコマンドの使用方法の詳細については、「Windows PowerShell を使用した Windows Server AppFabric キャッシュ機能の管理」を参照してください。

開発コンピューターの準備

AppFabric キャッシュ機能を使用するアプリケーションを開発するために必要なセットアップ要件は、AppFabric のキャッシュクライアント機能をインストールすることだけです。他の AppFabric キャッシュ機能がインストールされているキャッシュホストで開発することは可能ですが、開発ワークステーションではキャッシュクライアント機能が唯一の要件です。

Visual Studio プロジェクトの準備

キャッシュが有効なアプリケーションの開発に必要なアセンブリは、グローバルアセンブリキャッシュ (GAC) にインストールされます。これらのアセンブリを使用する Visual Studio .NET アプリケーションを開発するには、プロジェクトからアセンブリを参照する必要があります。

.NET Framework の正しいバージョンを選択するには

Visual Studio .NET プロジェクトを開きます。
ソリューションエクスプローラーで、プロジェクト名を右クリックし、[プロパティ] を選択します。
[プロジェクトのプロパティ] ダイアログの [アプリケーション] タブを選択します。
対象フレームワークのバージョンが .NET Framework 2.0 以降であることを確認します。

重要

対象フレームワークバージョンの Client Profile を使用しないでください。 Visual Studio 2008 では、[クライアント専用 Framework サブセット] チェックボックスをオフにします。 Visual Studio 2010 では、"Client Profile" を指定しない .NET Framework のバージョンを選択します。

AppFabric キャッシュアセンブリへの参照を追加するには

Visual Studio .NET プロジェクトを開きます。
ソリューションエクスプローラーで、プロジェクト名を右クリックし、[参照の追加] を選択します。
[参照の追加] ダイアログの [参照] タブを選択します。
.\Windows\System32\AppFabric ディレクトリに移動します。

ヒント

64 ビットオペレーティングシステムでは、AppFabric ディレクトリを直接表示することはできません。この問題の対応策として、System32 のディレクトリ名を SysNative という名前に置き換えます。その結果、この手順では C:\Windows\SysNative\AppFabric ディレクトリに移動します。
Microsoft.ApplicationServer.Caching.Client.dll および Microsoft.ApplicationServer.Caching.Core.dll という 2 つのアセンブリへの参照を追加します。
必要に応じて、コードファイルの先頭に using ステートメント (Visual Basic へのインポート) を追加して、Microsoft.ApplicationServer.Caching 名前空間を参照します。

キャッシュクライアントを構成するには

クライアントアプリケーションに対して適切なクライアント設定を決定します。キャッシュクライアントの種類の詳細については、「キャッシュクライアントとローカルキャッシュ (Windows Server AppFabric キャッシング)」を参照してください。
プログラムによって、またはアプリケーション構成ファイルを使用してキャッシュクライアントを構成します。これを行う方法の例については、「Windows Server AppFabric キャッシュクライアントの概要」および「Windows Server AppFabric キャッシュクライアントの概要 (XML)」を参照してください。

例

次に、アプリケーション構成ファイルを使用して構成したキャッシュクライアントの例を示します。この例ではローカルキャッシュを無効化し、 CacheServer1 および CacheServer2 という 2 つのキャッシュホストを指定しています。詳細については、「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"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

次の例は、クライアントをプログラムから構成する方法を示しています。この例ではローカルキャッシュを無効化し、1 つのキャッシュサーバーのみ (CacheServer2) を指定しており、NamedCache1 という名前のキャッシュに対してキャッシュクライアントを作成しています。詳細については、「Windows Server AppFabric キャッシュクライアントの概要」を参照してください。

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

キャッシュクライアント開発環境の準備 (Windows Server AppFabric キャッシュ)

開発コンピューターの準備

Visual Studio プロジェクトの準備

.NET Framework の正しいバージョンを選択するには

AppFabric キャッシュアセンブリへの参照を追加するには

キャッシュクライアントを構成するには

例

関連項目

概念

その他のリソース

その他のリソース

キャッシュ クライアント開発環境の準備 (Windows Server AppFabric キャッシュ)

開発コンピューターの準備

Visual Studio プロジェクトの準備

.NET Framework の正しいバージョンを選択するには

AppFabric キャッシュ アセンブリへの参照を追加するには

キャッシュ クライアントを構成するには

例

関連項目

概念

その他のリソース

その他のリソース

キャッシュクライアント開発環境の準備 (Windows Server AppFabric キャッシュ)

AppFabric キャッシュアセンブリへの参照を追加するには

キャッシュクライアントを構成するには