次の方法で共有

方法: Azure In-Role キャッシュを使用するように 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. 左側のウィンドウで、Online カテゴリを選択します。

  3. WindowsAzure.Cachingを検索します。

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

    キャッシュ プレビュー パッケージ (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>

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

手記

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< にインストールされます。ef\Caching>\r現在のバージョン。

関連項目

概念

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