Adicionar o Azure SignalR usando os Serviços Conectados do Visual Studio
Com o Visual Studio, você pode conectar qualquer um dos seguintes itens ao Azure SignalR usando o recurso Serviços Conectados:
- Aplicativo de console do .NET Framework
- ASP.NET Modelo-Visão-Controlador (MVC) (estrutura .NET)
- ASP.NET Core
- .NET Core (incluindo aplicativo de console, WPF, Windows Forms, biblioteca de classes)
- Função de trabalho do .NET Core
- Funções do Azure
- Aplicativo da Plataforma Universal do Windows
- Xamarin
- Cordova
A funcionalidade do serviço conectado adiciona todas as referências necessárias e o código de conexão ao seu projeto, bem como modifica os arquivos de configuração adequadamente.
Pré-requisitos
- Visual Studio com a carga de trabalho do Azure instalada.
- Um projeto de um dos tipos com suporte
- Uma conta do Azure. Se você não tiver uma conta do Azure, ative seus benefícios do Azure para assinantes do Visual Studio ou inscreva-se para uma avaliação gratuita.
Conectar-se ao Azure SignalR usando serviços conectados
Abra o projeto no Visual Studio.
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 Serviço Conectado.
Se você não vir o nó Serviços conectados, escolha Projeto>Serviços conectados>Adicionar.
Na guia Serviços Conectados, selecione o ícone + para Dependências de Serviço.
Na página Adicionar Dependência, selecione Serviço do Azure SignalR.
Se ainda não estiver conectado, entre em sua conta do Azure. Se não tiver uma conta do Azure, você poderá assinar uma versão de avaliação gratuita.
Na tela Configurar o Azure SignalR, selecione um componente existente do Azure SignalR e selecione Avançar.
Se precisar criar um componente, passe para a próxima etapa. Caso contrário, passe à etapa 7.
Para criar uma instância de Serviço do Azure SignalR:
Selecione Criar uma nova instância de Serviço do Azure SignalR na parte inferior da tela.
Preencha o Serviço do Azure SignalR: Criar Novo e selecione Criar.
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 Avançar.
Insira um nome de cadeia de conexão ou escolha o padrão e escolha se deseja que a cadeia de conexão seja armazenada em um arquivo de segredos local ou no Azure Key Vault.
A tela Resumo das alterações mostra todas as modificações que serão feitas no projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.
A conexão aparece na seção Dependências de Serviço da guia Serviços Conectados.
Conectar-se ao Azure SignalR usando serviços conectados
Observação
Para projetos .NET Framework, a interface do usuário dos Serviços Conectados é um pouco diferente. Para ver as diferenças, compare com a versão do Visual Studio 2019 desta página.
Abra o projeto no Visual Studio.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó serviço Conectados e, no menu de contexto, selecione Adicionar para abrir o menu de serviços disponíveis.
Se você não vir o nó Serviços conectados, escolha Projeto>Serviços conectados>Adicionar.
Escolha Serviço do Azure SignalR. A página Conectar-se à dependência é exibida.
Se ainda não estiver conectado, entre em sua conta do Azure. Se não tiver uma conta do Azure, você poderá assinar uma versão de avaliação gratuita.
Selecione um componente existente do Azure SignalR e selecione Avançar.
Se precisar criar um componente, passe para a próxima etapa. Caso contrário, passe à etapa 7.
Para criar uma instância de Serviço do Azure SignalR:
Selecione Criar no meio direito da tela.
Preencha o Serviço do Azure SignalR: Criar Novo e selecione Criar.
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 Avançar.
Insira um nome de configuração de conexão ou aceite o padrão.
Observação
Para maior segurança, no Visual Studio 17.12 e posterior, esta 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.
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 no Azure Key Vault.
A tela Resumo das alterações mostra todas as modificações que serão feitas no projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.
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:
Se você clicar nos três pontos ao lado da dependência adicionada, 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 as opções para iniciar dependências locais, alterar as configurações e muito mais.
Próximas etapas
Continue seguindo o início rápido do Azure SignalR. Você pode ignorar a configuração inicial, já que fez isso, e continuar na 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.