エクスポート (0) 印刷
すべて展開

方法:In-Role Cache を使用できるように Visual Studio を準備する (Azure Cache)

更新日: 2014年9月

noteメモ
アプリケーションに対して適切な Azure Cache サービスを選択するためのガイダンスについては、「どの Azure Cache を利用すればよいですか。」を参照してください。

このトピックでは、Microsoft Azure Cache を使用するように Visual Studio プロジェクトを準備する方法について説明します。次のような作業があります。

  • .NET Framework の正しいバージョンがターゲットであることを確認します。

  • キャッシュ アセンブリを参照します。

これらの作業を行った後、アプリケーションの dataCacheClient セクションまたは web.config ファイルでキャッシュ クライアントを構成できます。これにより、Microsoft.ApplicationServer.Caching 名前空間で キャッシュ のメソッドを使用できます。

Warning警告
同じコンピューターに Microsoft AppFabric 1.1 for Windows Server と Microsoft Azure Cache の両方をインストールしないでください。これには製品と SDK の両方が含まれます。グローバル アセンブリ キャッシュにある一部の Microsoft AppFabric 1.1 for Windows Server アセンブリを誤って参照する可能性があります。これが正しくない動作や予期しない動作の原因となる場合があります。

  1. Visual Studio プロジェクトを開きます。

  2. ソリューション エクスプローラーで、プロジェクト名を右クリックし、[プロパティ] を選択します。

  3. Visual C# プロジェクトの場合は、次の手順を使用します。

    1. [プロジェクトのプロパティ] ダイアログの [アプリケーション] タブを選択します。

    2. ターゲット フレームワークのバージョンが .NET Framework 2.0 以降であることを確認します (非クライアント プロファイル)。

  4. Visual Basic プロジェクトの場合は、次の手順を使用します。

    1. [プロジェクトのプロパティ] ページの [コンパイル] セクションを選択します。

    2. [コンパイル] ページの下部にある [詳細コンパイル オプション] ボタンをクリックします。

    3. ターゲット フレームワークのバージョンが .NET Framework 2.0 以降であることを確認します (非クライアント プロファイル)。

Important重要
対象フレームワーク バージョンのクライアント プロファイルを使用しないでください。Visual Studio では、"Client Profile" を指定しない .NET Framework のバージョンを選択します。

アセンブリ参照を追加するには、Azure SDK がコンピューターにインストールされている必要があります。詳細については、「Azure SDK のダウンロード」を参照してください。

次の手順では、NuGet パッケージを使用して必要なアセンブリ参照と構成の変更を追加します。これらの手順は、同じデプロイ内の Azure ロールでホストされる インロール キャッシュ を使用する場合のものです。

  1. ソリューション エクスプローラーで、プロジェクト名を右クリックし、[ライブラリ パッケージ参照の追加] (NuGet 1.2) または [Nuget パッケージの管理] (NuGet 2.0 以降) を選択します。

  2. 左側のウィンドウで、[オンライン] カテゴリを選択します。

  3. [WindowsAzure.Caching] を探します。

  4. Microsoft.WindowsAzure.Caching (NuGet 1.2) または Azure Caching (NuGet 2.0 以降) という名前の インロール キャッシュ パッケージをインストールします。

    キャッシュ プレビュー パッケージ (NuGet 1.2) のスクリーンショット

    キャッシュ プレビュー パッケージ (NuGet 2.0) のスクリーンショット

このパッケージでは、適切なアセンブリ参照を追加することに加えて、ターゲット プロジェクトの構成ファイル (app.config または web.config) も変更されます。次のようなボイラープレート dataCacheClient セクションが追加されます。

<dataCacheClients>
  <dataCacheClient name="default">
    <autoDiscover isEnabled="true" identifier="[cache cluster role name]" />
    <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
  </dataCacheClient>
</dataCacheClients>

最後の手順では、identifier 属性が "[cache cluster role name]" から インロール キャッシュ が有効になっているロールの実際の名前に変更されます。併置型トポロジでは、これは "WebRole1" のように同じロールになります。専用トポロジでは、これは "CacheWorkerRole1" のように別のロールになります。両方のトポロジのサンプルについては、「In-Role Cache のサンプル (Azure Cache)」を参照してください。

noteメモ
dataCacheClients セクションがカスタマイズされていた場合、NuGet パッケージをアンインストールしても、そのセクションは削除されません。手動で削除する必要があります。

NuGet パッケージにより、次のアセンブリへの参照が追加されます。

  • Microsoft.ApplicationServer.Caching.AzureClientHelper

  • Microsoft.ApplicationServer.Caching.AzureCommon

  • Microsoft.ApplicationServer.Caching.Client

  • Microsoft.ApplicationServer.Caching.Core

  • Microsoft.Web.DistributedCache

  • Microsoft.WindowsFabric.Common

  • Microsoft.WindowsFabric.Data.Common

noteメモ
NuGet パッケージを使用しなくても、これらのアセンブリを手動で参照できます。既定では、C:\Program Files\Microsoft SDKs\Azure\.NET SDK\<current version>\ref\Caching にインストールされます。

関連項目

表示:
© 2015 Microsoft