Adicionando o Armazenamento do Azure usando o Visual Studio Connected Services

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

• Aplicativo de console do .NET Framework
• Modelo ASP.NET -View-Controller (MVC) (.NET Framework)
• ASP.NET Núcleo
• .NET Core (incluindo aplicativo de console, WPF, Windows Forms, biblioteca de classes)
• Função de trabalho principal do .NET
• Azure Functions (Funções do Azure)
• Aplicativo da Plataforma Universal do Windows
• Córdova

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

Pré-requisitos

• Visual Studio (consulte [Downloads do Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) com a carga de trabalho de desenvolvimento do Azure instalada.
• Um projeto de um dos tipos apoiados
• Uma conta do Azure. Se não tiver uma conta do Azure, ative os seus benefícios do Azure para assinantes do Visual Studio ou inscreva-se para uma avaliação gratuita.

Conectar-se ao Armazenamento do Azure usando os Serviços Conectados

1. Abra seu projeto no Visual Studio.

2. Pressione Ctrl+Q (ou use o botão de pesquisa no IDE do Visual Studio à direita da barra de menu principal).

3. Na pesquisa de funcionalidades , introduza Azure Storagee escolha Armazenamento do Azure - Project > Serviços Conectados > Adicionar > Armazenamento do Azure.

   

4. Na página Conectar à dependência, selecione Armazenamento do Azure, e depois selecione Avançar.

   

   Caso ainda não tenha efetuado login, faça-o na sua conta do Azure. Se não tiver uma conta do Azure, pode inscrever-se para uma avaliação gratuita .

5. No ecrã Conectar ao Armazenamento do Azure, selecione uma conta de armazenamento existente e selecione Avançar.

   Se você precisar criar uma conta de armazenamento, vá para a próxima etapa. Caso contrário, pule para a etapa a seguir.

   

6. Para criar uma conta de armazenamento:

   1. Selecione Criar novo usando o sinal de mais verde.

   2. Preencha a caixa de diálogo "Armazenamento do Azure: Criar novo" e selecione "Criar" .

      

   3. Quando a caixa de diálogo de Armazenamento do Azure é exibida, a nova conta de armazenamento aparece na lista. Selecione a nova conta de armazenamento na lista e selecione Avançar.

7. Insira um nome de configuração de cadeia de conexão. O nome da configuração faz referência ao nome da configuração da cadeia de conexão conforme aparece no arquivo secrets.json ou no Cofre da Chave do Azure.

   

8. Escolha se deseja que a cadeia de conexão seja armazenada em um arquivo secreto local, em do Cofre de Chaves do Azure ou não seja armazenada em qualquer lugar.

   

   Atenção

   Se você estiver usando uma versão do Visual Studio anterior ao Visual Studio 17.12 e optar por usar um arquivo secrets.json, você deve tomar precauções de segurança, pois a cadeia de conexão no arquivo secrets.json local pode ser exposta. Se você estiver usando o Visual Studio 2022 versão 17.12 ou posterior, esse procedimento produzirá resultados mais seguros, porque produz um valor de configuração de conexão, em vez de uma cadeia de conexão com credenciais de autenticação.

9. A tela 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 OK, escolha Concluir.

   

10. O serviço de armazenamento conectado aparece sob o nó Serviços Conectados do seu projeto.

Compreender a autenticação

Depois de executar o procedimento anterior, seu aplicativo é configurado para usar a autenticação para acessar a conta de armazenamento. As informações de conexão para essa autenticação são armazenadas localmente, se você escolher o método secrets.json, ou em seu Cofre de Chaves do Azure.

Se você usou o arquivo secrets.json, abra o arquivo usando os três pontos ao lado de Secrets.json na guia Serviços Conectados para abrir um menu e escolha Gerenciar segredos do usuário. Com o Visual Studio 2022 versão 17.12 e posterior, esse arquivo contém configurações que fazem referência a um URI para obter a cadeia de conexão segura, em vez da cadeia de conexão em si.

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

Com essas configurações no Visual Studio 17.12 e posterior, a autenticação é automática e flexível. Quando você executa ou depura localmente do Visual Studio, suas credenciais do Azure salvas pelo Visual Studio são usadas para acessar a conta de Armazenamento do Azure. Se você iniciar seu aplicativo a partir da linha de comando, primeiro precisará entrar usando a CLI do Azure e essas credenciais serão automaticamente detetadas e usadas. Mas quando seu aplicativo é implantado no Azure e executado no Azure, ele usa a identidade gerenciada, sem alterações de código. A autenticação funciona em todos os ambientes de hospedagem porque as APIs de Identidade do Azure verificam todas as credenciais encadeadas em sequência e as usam quando são encontradas. Consulte DefaultAzureCredential.

Próximos passos

O Armazenamento do Azure suporta tanto blobs quanto filas, assim como outros recursos.

Para saber mais sobre como trabalhar com blobs, você pode continuar com o início rápido para armazenamento de blobs, mas em vez de começar no início, você pode começar em início rápido de blobs do Azure (.NET) - Exemplos de código.

Para saber mais sobre como trabalhar com filas, comece em início rápido do Armazenamento de Filas do Azure (.NET) - Exemplos de código.

Conteúdo relacionado

• Fórum de Armazenamento do Azure
• Documentação do Armazenamento do Azure