Início Rápido: Criar um aplicativo .NET com a Configuração de Aplicativos

Artigo
04/10/2024

Neste guia de início rápido, você incorpora a Configuração de Aplicativos do Azure em um aplicativo de console .NET para centralizar o armazenamento e o gerenciamento de configurações de aplicativo separadas do seu código.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
Um repositório de Configuração de Aplicativos. Criar um repositório.
SDK .NET 6.0 ou posterior - também disponível no Azure Cloud Shell.

Adicionar um valor-chave

Adicione o valor-chave a seguir ao repositório de Configuração de Aplicativos e deixe os campos Rótulo e Tipo de Conteúdo com seus valores padrão. Para mais informações sobre como adicionar valores-chave a um repositório usando o portal do Azure ou a CLI, acesse Criar um valor-chave.

Chave	Valor
TestApp:Settings:Message	Dados da Configuração de Aplicativo do Azure

Criar um aplicativo de console do .NET

Você pode usar a Interface de linha de comando (CLI) do .NET para criar um novo projeto de aplicativo de console do .NET. A vantagem de usar a CLI do .NET em relação ao Visual Studio é que ela está disponível nas plataformas Windows, macOS e Linux. Como alternativa, use as ferramentas pré-instaladas disponíveis no Azure Cloud Shell.

Crie uma nova pasta para o seu projeto.
Na nova pasta, execute o seguinte comando para criar um projeto de aplicativo de console .NET:
```
dotnet new console
```

Conectar um repositório de Configuração de Aplicativos

Adicione uma referência ao pacote NuGet Microsoft.Extensions.Configuration.AzureAppConfiguration, executando o seguinte comando:
```
dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
```
Execute o seguinte comando para restaurar pacotes do projeto:
```
dotnet restore
```

Abra Program.cs e adicione as seguintes instruções:

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

Use a Configuração de Aplicativos chamando o método AddAzureAppConfiguration no arquivo Program.cs.

var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));

var config = builder.Build();
Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");

Compilar e executar o aplicativo localmente

Defina uma variável de ambiente chamada ConnectionString e defina-a como a chave de acesso ao repositório de Configuração de Aplicativos. Na linha de comando, execute o seguinte comando:
Para criar e executar o aplicativo localmente usando o prompt de comando do Windows, execute o seguinte comando:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Reinicie o prompt de comando para permitir que a alteração entre em vigor. Imprima o valor da variável de ambiente para validar que ele está definido corretamente.
Se você usa o Windows PowerShell, execute o comando a seguir:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Se você usar o macOS, execute o seguinte comando:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Se você usar o Linux, execute o seguinte comando:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Execute o seguinte comando para compilar o aplicativo de console:
```
dotnet build
```
Depois que a construção for concluída com êxito, execute o seguinte comando para executar o aplicativo localmente:
```
dotnet run
```

Limpar os recursos

Se não deseja continuar usando os recursos criados neste artigo, exclua o grupo de recursos que você criou aqui para evitar encargos.

Importante

A exclusão de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos contidos nele são excluídos permanentemente. Não exclua acidentalmente grupo de recursos ou recursos incorretos. Se tiver criado os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que você deseja manter, exclua cada um individualmente do respectivo painel em vez de excluir o grupo de recursos.

Entre no portal do Azure e selecione Grupos de recursos.
Na caixa Filtrar por nome..., digite o nome do seu grupo de recursos.
Na lista de resultados, selecione o nome do grupo de recursos para conferir uma visão geral.
Selecione Excluir grupo de recursos.
Você receberá uma solicitação para confirmar a exclusão do grupo de recursos. Insira o nome do grupo de recursos para confirmar e selecione Excluir.

Após alguns instantes, o grupo de recursos e todos os recursos dele são excluídos.

Próximas etapas

Neste início rápido, você criou um novo repositório no Configuração de Aplicativos e o usou com um aplicativo de console .NET por meio do provedor da Configuração de Aplicativos. Para saber como configurar seu aplicativo .NET para atualizar dinamicamente as configurações, passe para o próximo tutorial.

Habilitar configuração dinâmica