Compartilhar via

Adicionar o Cache do Azure para Redis usando os Serviços Conectados do Visual Studio

Com o Visual Studio, você pode conectar qualquer uma das seguintes opções ao Cache do Azure para Redis usando o recurso Serviços Conectados:

  • Aplicativo de console do .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (incluindo aplicativo de console, WPF, Windows Forms, biblioteca de classes)
  • Função de Trabalho do .NET Core
  • Azure Functions
  • Aplicativo da Plataforma Universal do Windows
  • Cordova

A funcionalidade de serviço conectado adiciona todas as referências necessárias e código de conexão ao seu projeto e modifica os arquivos de configuração adequadamente.

Pré-requisitos

Conectar-se ao Cache do Azure para Redis usando serviços conectados

Nota

Para projetos do .NET Framework, a interface do usuário dos Serviços Conectados é ligeiramente diferente. Para ver as diferenças, compare com a versão do Visual Studio 2019 desta página .

  1. Abra seu projeto no Visual Studio.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Serviços Conectados e, no menu de contexto, selecione Adicionar para abrir o menu de serviços disponíveis.

    Captura de tela mostrando opções de menu de contexto dos Serviços Conectados.

    Se você não vir o nó Serviços Conectados, escolha Projeto>Serviços Conectados>Adicionar.

  3. Escolha Cache do Azure para Redis. A página Conectar-se à dependência é exibida. Você deverá ver duas opções: uma para um emulador local, Cache Redis no contêiner (Local), e outra para se conectar ao serviço ativo do Azure Cache para Redis. Você pode reduzir o custo e simplificar o desenvolvimento antecipado começando com o emulador local. Você pode migrar para o serviço ao vivo mais tarde repetindo essas etapas e escolhendo a outra opção.

    captura de tela mostrando as opções do Cache do Azure para Redis

    Se você escolher o Cache do Azure para Redis localmente, clique em Avançar na tela Conectar-se ao cache Redis no contêiner.

    Captura de tela mostrando as opções de conexão para o Cache do Azure para Redis em um contêiner local.

    Especifique o Nome do contêiner , a Imagem do contêiner e os mapeamentos de porta ou aceite os padrões existentes e clique em Próximo para ver a tela Resumo das alterações , que mostra quais alterações seriam feitas em seu projeto. Uma referência de pacote NuGet é adicionada ao seu projeto e o código de conexão do emulador local é adicionado ao seu projeto.

    Se você quiser se conectar ao serviço do Azure, continue para a próxima etapa ou, se ainda não estiver conectado, entre em sua conta do Azure antes de continuar. Se você não tiver uma conta do Azure, poderá se inscrever para uma avaliação gratuita .

  4. Para usar o serviço em tempo real, selecione Cache do Azure para Redis.

    Captura de tela da página Adicionar Dependência. O Cache do Azure para Redis está selecionado.

    Se você ainda não estiver conectado, entre em sua conta do Azure. Se você não tiver uma conta do Azure, poderá se inscrever para uma avaliação gratuita .

  5. Na tela Configurar Cache do Azure para Redis, selecione um Cache do Azure para Redis existente e selecione Avançar.

    Se você precisar criar um novo componente, vá para a próxima etapa. Caso contrário, pule para a etapa 7.

    Captura da tela Configurar Cache do Azure para Redis. Avançar está destacado.

  6. Para criar um Cache do Azure para Redis:

    1. Selecione Criar um novo Cache Redis do Azure na parte inferior da tela.

    2. Preencha a tela Cache do Azure para Redis: criar e selecione Criar.

      Captura de tela da página criar Cache do Azure para Redis. Criar está destacado.

    3. Quando a tela Configurar Cache do Azure para Redis é exibida, o novo cache aparece na lista. Selecione o novo banco de dados na lista e selecione Próximo.

  7. Insira um nome de configuração de conexão ou aceite o padrão.

    Captura de tela da página de informações de conexão do Cache do Azure para Redis. Avançar está destacado.

    Nota

    Para melhorar a segurança, no Visual Studio 17.12 e posterior, essa etapa cria um nome de configuração de conexão; as versões anteriores criam uma cadeia de conexão. As cadeias de conexão armazenadas no sistema de arquivos local podem levar a um risco de segurança, se forem expostas inadvertidamente.

  8. Clique em Configurações adicionais e escolha se deseja que a configuração de conexão seja armazenada em um arquivo de segredos local ou em do Azure Key Vault.

    Captura de tela da página de configurações adicionais do Cache do Azure para Redis.

  9. A tela de resumo das alterações mostra todas as modificações que serão feitas no seu projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.

    Captura de tela da página Resumo das alterações. A conclusão está realçada.

  10. No Gerenciador de Soluções, clique duas vezes no nó Serviços Conectados para abrir a guia Serviços Conectados. A conexão é exibida na seção Dependências de Serviço:

    Captura de tela mostrando uma lista de dependências de serviço configuradas.

    Se você clicar no ícone de três pontos ao lado da dependência que você adicionou, poderá ver várias opções, como Conectar para reabrir o assistente e alterar a conexão. Você também pode clicar nos três pontos no canto superior direito da janela para ver opções para iniciar dependências locais, alterar configurações e muito mais.

Próximas etapas

Para aplicativos ASP.NET, os casos de uso comuns do Cache do Azure para Redis são armazenar em cache o estado da sessão ou a saída da página (respostas HTTP). ASP.NET Core fornece serviços internos para esses casos de uso, que devem ser usados quando você estiver usando ASP.NET Core.

Para armazenar em cache o estado da sessão em um aplicativo ASP.NET, consulte o Provedor de Estado de Sessão do ASP.NET.

Para armazenar em cache a saída da página em um aplicativo ASP.NET, consulte o Provedor de Cache de Saída do ASP.NET .

Conteúdo relacionado

  • Last updated on