Como preparar Visual Studio para usar o Cache de In-Role do Azure

Este tópico explica como preparar um projeto de Visual Studio para usar Microsoft Azure Cache. Isso inclui as seguintes tarefas:

• Verificar se a versão correta do .NET Framework foi definida como destino.

• Faça referência aos assemblies de cache.

Após essas tarefas, você pode configurar seu cliente de cache na seção dataCacheClient do aplicativo ou web.config arquivos. Isso permite que você use os métodos de cache no namespace Microsoft.ApplicationServer.Caching.

Para apontar para a versão correta do .NET Framework

1. Abra seu projeto do Visual Studio.

2. No Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e selecione Propriedades.

3. Para um projeto em Visual C#, use as seguintes etapas:

   1. Selecione a guia Aplicativo da caixa de diálogo Propriedades do Projeto.

   2. Verifique se a versão do framework de destino é .NET Framework 2.0 ou superior (perfil de não cliente).

4. Para um projeto em Visual Basic, usa as seguintes etapas:

   1. Selecione a seção Compilar da página Propriedades do Projeto.

   2. Na parte inferior da página Compilar, clique no botão Opções Avançadas de Compilação.

   3. Verifique se a versão do framework de destino é .NET Framework 2.0 ou superior (perfil de não cliente).

Configurar um projeto para cache em funções

Para adicionar as referências de assembly, você deve ter o SDK do Azure instalado em seu computador. Para obter instruções, consulte o Download do SDK do Azure.

As etapas a seguir usam um pacote NuGet para adicionar as referências a assembly e alterações de configuração necessárias. Essas etapas são específicas para usar In-Role Cache hospedado em uma função do Azure na mesma implantação.

1. No Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e selecione Adicionar Referência a Pacote de Biblioteca (NuGet 1.2) ou Gerenciar Pacotes NuGet (NuGet 2.0 ou superior).

2. No painel da esquerda, selecione a categoria Online.

3. Procure por WindowsAzure.Caching.

4. Instale o pacote cache In-Role chamado Microsoft.WindowsAzure.Caching (NuGet 1.2) ou Caching do Azure (NuGet 2.0 ou superior).

   

   

Além de adicionar as referências a assembly apropriadas, esse pacote também modifica o arquivo de configuração (app.config ou web.config) para o projeto de destino. Ele adiciona uma seção boilerplate dataCacheClient semelhante à seguinte.

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

A etapa final é alterar o atributo do identificador de "[cache cluster role name]" para o nome real da função que tem In-Role Cache habilitado. Em uma topologia colocalizada, essa pode ser a mesma função, como, por exemplo, "WebRole1". Em uma topologia dedicada, essa pode ser uma função diferente, como, por exemplo, "CacheWorkerRole1". Para obter exemplos de ambas as topologias, consulte exemplos de cache do Azure In-Role.

O pacote NuGet adiciona referências aos seguintes assemblies:

• 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

Consulte Também

Conceitos

Desenvolver para Cache na função do Azure
Provedores de cache ASP.NET 4 para o Cache na Função do Azure