如何：準備Visual Studio使用 Azure In-Role 快取

  • 發行項

重要

Microsoft 建議所有新的開發都使用 Azure Redis 快取。 如需選擇 Azure 快取供應專案的目前檔和指引，請參閱 哪個 Azure 快取供應專案適合我？

本主題說明如何準備Visual Studio專案以使用 Microsoft Azure Cache。 這包括下列工作：

  • 確認目標的 .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版本。

為角色上的 Caching 設定專案

若要新增元件參考，您必須在電腦上安裝 Azure SDK。 如需指示，請參閱 Azure SDK 下載。

下列步驟使用 NuGet 封裝來新增必要的組件參考和設定變更。 這些步驟是使用在相同部署中裝載于 Azure 角色上的In-Role快取。

  1. 在 [方案總管] 中的專案名稱上按一下滑鼠右鍵，然後選取 [新增程式庫封裝參考] (NuGet 1.2) 或 [管理 NuGet 封裝] (NuGet 2.0 或更高)。

  2. 在左窗格中，選取 [線上] 類別。

  3. 搜尋 WindowsAzure.Caching。

  4. 安裝名為Microsoft.WindowsAzure.Cacheing In-Role (NuGet 1.2) 或Azure Cacheing (NuGet 2.0 或更高版本的快取套件) 。

    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快取範例。

注意

如果已自訂該區段，則卸載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 SDKs\Azure\.NET SDK & lt;current version > \ref\Cacheing。

另請參閱

概念

開發 Azure In-Role Cache
適用於 Azure 角色中快取的 ASP.NET 4 快取提供者