Início Rápido: Criar um aplicativo .NET Framework com a Configuração de Aplicativo do Azure

Artigo
03/30/2023

Há duas maneiras de incorporar a Configuração de Aplicativos do Azure em um .NET Framework baseado em dados.

O construtor de configuração para a Configuração de Aplicativos permite que os dados da Configuração de Aplicativos sejam carregados nas Configurações do Aplicativo. Seu aplicativo acessa a configuração como sempre faz, por meio de ConfigurationManager. Você não precisa fazer nenhuma alteração de código além de atualizações aos arquivos app.config ou web.config. Este guia de início rápido orientará você por essa opção.
Como são projetadas pelo .NET Framework, as Configurações do Aplicativo podem ser atualizadas somente após a reinicialização do aplicativo. O provedor .NET da Configuração de Aplicativos é uma biblioteca .NET Standard. Ele dá suporte ao cache e à atualização da configuração dinamicamente, sem reinicialização do aplicativo. Se a configuração dinâmica for essencial para você e você estiver disposto a fazer alterações de código, confira tutoriais sobre como você pode implementar atualizações de configuração dinâmica em um aplicativo de console do .NET Framework ou em um aplicativo Web ASP.NET.

Neste guia de início rápido, um aplicativo de console do .NET Framework é usado como exemplo, mas a mesma técnica se aplica a um aplicativo ASP.NET Web Forms/MVC.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
Um repositório de Configuração de Aplicativos. Crie um repositório.
Visual Studio
.NET Framework 4.7.2 ou posterior

Adicione 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 .NET Framework

Inicie o Visual Studio e selecione Criar um projeto.
Em Criar um projeto, filtre o tipo de projeto Console e selecione Aplicativo de Console (.NET Framework) com C# na lista de modelos de projeto. Pressione Avançar.
Em Configurar seu novo projeto, insira um nome de projeto. Em Framework, selecione .NET Framework 4.7.2 ou superior. Pressione Criar.

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

Clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes do NuGet. Na guia Navegar, pesquise e adicione os seguintes pacotes do NuGet ao projeto.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration versão 1.0.0 ou posterior
- Microsoft.Configuration.ConfigurationBuilders.Environment versão 2.0.0 ou posterior
- System.Configuration.ConfigurationManager versão 4.6.0 ou posterior

Atualize o arquivo App.config do projeto, conforme a seguir:

<configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
</configSections>

<configBuilders>
    <builders>
        <add name="MyConfigStore" mode="Greedy" connectionString="${ConnectionString}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
        <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
</configBuilders>

<appSettings configBuilders="Environment,MyConfigStore">
    <add key="AppName" value="Console App Demo" />
    <add key="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
</appSettings>

A cadeia de conexão do repositório de Configuração de Aplicativos é lida na variável de ambiente ConnectionString. Adicione o Environment construtor de configuração antes de MyConfigStore na propriedade configBuilders da seção appSettings.

Abra Program.cs e atualize o método Main para usar a Configuração de Aplicativo, chamando ConfigurationManager.

static void Main(string[] args)
{
    string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];

    Console.WriteLine(message);
    Console.ReadKey();
}

Compilar e executar o aplicativo

Defina uma variável de ambiente chamada ConnectionString como a cadeia de conexão de chave somente leitura obtida durante a criação do repositório de Configuração de Aplicativos.

Se você usar o prompt de comando do Windows, execute o seguinte comando:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Se você usa o Windows PowerShell, execute o comando a seguir:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Reinicie o Visual Studio para permitir que a alteração tenha efeito.
Pressione Ctrl + F5 para criar e executar o aplicativo do console. Você deverá ver a mensagem das saídas da Configuração de Aplicativos no console.

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 repositório de Configuração de Aplicativos e o utilizou com um aplicativo de console .NET Framework. Para saber como permitir que o aplicativo .NET Framework atualize configurações dinamicamente, passe para o próximo tutorial.

Habilitar a configuração dinâmica em um aplicativo .NET Framework

Habilitar a configuração dinâmica em um aplicativo Web ASP.NET