导出 (0) 打印
全部展开

如何:准备 Visual Studio 以使用角色中缓存(Azure 缓存)

更新时间: 2010年7月

本主题将说明如何准备 Visual Studio 项目以使用 Microsoft Azure Cache。这包括以下任务:

  • 验证是否确定了 .NET Framework 的正确版本。

  • 引用缓存程序集。

完成这些任务后,可以在应用程序或 web.config 文件的 dataCacheClient 节中配置缓存客户端。这样,你就能够在 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 中,请选择未指定“客户端配置文件”的 .NET Framework 版本。

若要添加程序集引用,必须已在计算机上安装 SDK。有关说明,请参阅 Azure SDK 下载

以下步骤将使用 NuGet 程序包添加所需的程序集引用和配置更改。这些步骤特定于使用同一部署中 角色中缓存 角色上托管的。

  1. “解决方案资源管理器”中,右键单击项目名称,然后选择“添加库程序包引用”(NuGet 1.2) 或“管理 NuGet 程序包”(NuGet 2.0 或更高版本)。

  2. 在左窗格中,选择“联机”类别。

  3. 搜索 WindowsAzure.Caching

  4. 安装名为 Microsoft.WindowsAzure.Caching (NuGet 1.2) 或 Azure Caching(NuGet 2.0 或更高版本)的角色中缓存程序包。

    Caching 预览包 (NuGet 1.2) 的屏幕快照

    Caching 预览包 (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")。有关这两种拓扑的示例,请参阅角色中缓存示例(Azure 缓存)

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\<当前版本>\ref\Caching。

另请参阅

显示:
© 2014 Microsoft