VENDAS: 1-800-867-1389

Como: Preparar o Visual Studio para usar cache na função (cache do Azure)

Atualizado: setembro de 2014

noteObservação
Para orientação sobre como escolher a oferta Azure Cache para seu aplicativo, consulte Qual oferta de cache do Azure é ideal para mim?.

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

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

  • Referenciar os assemblies do caching.

Tendo concluído essas tarefas, você poderá configurar o cliente de cache na seção dataCacheClient do arquivo de configuração do aplicativo ou do arquivo web.config. Isso lhe permitirá usar os métodos caching no namespace Microsoft.ApplicationServer.Caching.

WarningAviso
Não é recomendável instalar o Microsoft AppFabric 1.1 for Windows Server e o Cache do Microsoft Azure na mesma máquina. Isso inclui tanto o produto como o SDK. É possível referenciar equivocadamente alguns dos assemblies do Microsoft AppFabric 1.1 for Windows Server no cache de assembly global. Isso pode resultar em comportamento incorreto ou inesperado.

  1. Abra o 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).

ImportantImportante
Não use o perfil de cliente para a versão do framework de destino. No Visual Studio, selecione versões do .NET Framework que não especifiquem "Perfil de Cliente".

Para adicionar as referências a assembly, você precisará ter o SDK do Azure instalado em sua máquina. Para obter instruções, consulte 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 o uso de um Cache na Função 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 do Cache na Função denominado Microsoft.WindowsAzure.Caching (NuGet 1.2) ou Cache do Azure (NuGet 2.0 ou superior).

    Captura de tela do Pacote de Visualização de Caching (NuGet 1,2)

    Captura de tela do Pacote de Visualização de Caching (NuGet 2,0)

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 dataCacheClient genérica semelhante à que é mostrada a seguir.

<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 identifier de "[cache cluster role name]" para o nome real da função que tem o Cache na Função 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 na função (cache do Azure).

noteObservação
A desinstalação do pacote NuGet não remove a seção dataCacheClients se essa seção tiver sido personalizada. Ela terá que ser removida manualmente.

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

noteObservação
É possível referenciar manualmente esses assemblies sem o pacote NuGet. Por padrão, eles são instalados em C:\Arquivos de Programas\Microsoft SDKs\Azure\.NET SDK\<versão atual>\ref\Caching.

Consulte também

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2015 Microsoft