Compartilhar via


Adicionar o Azure SignalR usando os Serviços Conectados do Visual Studio

Com o Visual Studio, você pode conectar qualquer um dos seguintes ao serviço Azure SignalR usando o recurso Serviços Conectados:

  • Aplicativo de console do .NET Framework
  • MVC (Model-View-Controller) do ASP.NET (.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 Azure SignalR 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 Serviço do Azure SignalR. A página Conectar-se à dependência é exibida.

    Captura de tela mostrando Conectar-se à dependência para o Azure SignalR.

    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 .

  4. Selecione um componente existente do Azure SignalR e selecione Próximo.

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

    Captura de tela mostrando a tela

  5. Para criar uma instância de serviço do Azure SignalR:

    1. Selecione Criar novo à direita, no meio da tela.

    2. Preencha o Serviço do Azure SignalR: Criar Novo e selecione Criar.

      Captura de tela mostrando a tela

    3. Quando a tela Configurar Serviço do Azure SignalR é exibida, a nova instância aparece na lista. Selecione a nova instância na lista e selecione Próximo.

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

    Captura de tela mostrando a tela

    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.

  7. Clique em Configurações adicionais e escolha se deseja que as informações de conexão sejam armazenadas em um arquivo de segredos local ou em do Azure Key Vault.

    Captura de tela mostrando configurações adicionais com opções para armazenar a configuração de conexão.

  8. 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 mostrando a tela

  9. 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 a seção

    Se você clicar nos três pontos ao lado da dependência que você adicionou, poderá ver várias opções, como Conectar, para reabrir o assistente e modificar 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

Continue seguindo o guia de início rápido do Azure SignalR. Você pode ignorar a configuração inicial, já que já fez isso e continuar com a seção Adicionar o Azure SignalR ao aplicativo Web. O código que você usa varia dependendo da sua versão do ASP.NET Core, portanto, talvez seja necessário modificar o código no tutorial para se adequar ao modelo de projeto se a versão do ASP.NET Core não corresponder à versão usada no início rápido.