Guia de início rápido: criar um aplicativo .NET Framework com a Configuração de Aplicativo do Azure

Artigo
02/23/2024

Há duas maneiras de incorporar a Configuração de Aplicativo do Azure em um aplicativo baseado no .NET Framework.

O construtor de configurações para Configuração de Aplicativo permite que os dados da Configuração de Aplicativo sejam carregados nas Configurações de Aplicativo. Seu aplicativo acessa a configuração como sempre faz via ConfigurationManager. Você não precisa fazer nenhuma alteração de código além de atualizações para arquivos app.config ou web.config. Este guia de início rápido irá guiá-lo através desta opção.
Conforme projetado pelo .NET Framework, as Configurações do Aplicativo só podem ser atualizadas após a reinicialização do aplicativo. O provedor .NET de Configuração de Aplicativo é uma biblioteca .NET Standard. Ele suporta cache e atualização de 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, consulte tutoriais sobre como implementar atualizações de configuração dinâmica em um aplicativo de console do .NET Framework ou em um aplicativo Web ASP.NET.

Neste 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 subscrição ativa. Crie um gratuitamente.
Uma loja de configuração de aplicativos. Crie uma loja.
Visual Studio
.NET Framework 4.7.2 ou posterior

Adicionar um valor-chave

Adicione o seguinte valor-chave à loja de Configuração de Aplicativos e deixe Rótulo e Tipo de Conteúdo com seus valores padrão. Para obter mais informações sobre como adicionar valores-chave a uma loja usando o portal do Azure ou a CLI, vá para Criar um valor-chave.

Key	valor
TestApp:Configurações:Mensagem	Dados da Configuração do Aplicativo do Azure

Criar um aplicativo de console do .NET Framework

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

Conectar-se a uma loja de configuração de aplicativos

Clique com o botão direito do mouse em seu projeto e selecione Gerenciar pacotes NuGet. Na guia Procurar, pesquise e adicione os seguintes pacotes NuGet ao seu 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 seu projeto da seguinte maneira:

<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 da sua App Configuration Store é lida a partir da variável ConnectionStringde ambiente . Adicione o Environment construtor de configurações antes da propriedade in da MyConfigStoreconfigBuildersappSettings seção.

Abra o Program.cs e atualize o método para usar a Configuração do Main 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 a aplicação

Defina uma variável de ambiente chamada ConnectionString como a cadeia de conexão de chave somente leitura obtida durante a criação da App Configuration Store.

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

Clean up resources (Limpar recursos)

Se não quiser continuar a utilizar os recursos criados neste artigo, elimine o grupo de recursos que criou aqui para evitar cobranças.

Importante

A eliminação de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos nele contidos são excluídos permanentemente. Certifique-se de não excluir acidentalmente o grupo de recursos ou recursos errados. Se você criou os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que deseja manter, exclua cada recurso individualmente de seu respetivo painel em vez de excluir o grupo de recursos.

Entre no portal do Azure e selecione Grupos de recursos.
Na caixa Filtrar por nome, introduza o nome do seu grupo de recursos.
Na lista de resultados, selecione o nome do grupo de recursos para ver uma visão geral.
Selecione Eliminar grupo de recursos.
É-lhe pedido que confirme a eliminação do grupo de recursos. Insira o nome do grupo de recursos a ser confirmado e selecione Excluir.

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

Próximos passos

Neste início rápido, você criou uma nova loja de Configuração de Aplicativo e a usou com um aplicativo de console do .NET Framework. Para saber como habilitar seu aplicativo .NET Framework para atualizar dinamicamente as definições de configuração, continue para os próximos tutoriais.

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

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