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

重要

Microsoft では、すべての新しい開発で Azure Redis Cache を使用することをお勧めします。 Azure Cache オファリングの選択に関する最新のドキュメントとガイダンスについては、「自分に適した Azure Cache オファリング」を参照してください。

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

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

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

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

警告

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

.NET Framework の正しいバージョンをターゲットにするには

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

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

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

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

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

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

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

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

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

重要

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

ロールでのキャッシュに対応したプロジェクトを構成する

アセンブリ参照を追加するには、マシンに Azure SDK がインストールされている必要があります。 手順については、 Azure SDK のダウンロードに関するページを参照してください。

次の手順では、NuGet パッケージを使用して必要なアセンブリ参照と構成の変更を追加します。 これらの手順は、同じデプロイで Azure ロールでホストされる In-Role Cache の使用に固有です。

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

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

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

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

    Screenshot of Caching Preview Package (NuGet 1.2)

    Screenshot of Caching Preview Package (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>

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

注意

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

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

注意

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

参照

概念

Azure In-Role Cache 用の開発
Azure In-Role Cache 用の ASP.NET 4 キャッシュ プロバイダー