Compartilhar via

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

  • Artigo

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 orienta 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, consulte 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

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

  1. Inicie o Visual Studio e selecione Criar um projeto.

  2. 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.

  3. 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

Conecte-se ao seu repositório da Configuração de Aplicativos usando o Microsoft Entra ID (recomendado) ou uma cadeia de conexão.

  1. Clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes do NuGet. Na guia Procurar, pesquise e adicione as versões estáveis mais recentes dos seguintes pacotes NuGet ao seu projeto.

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
    • Microsoft.Configuration.ConfigurationBuilders.Azure
    • System.Configuration.ConfigurationManager

  2. Atualize o arquivo App.config do projeto, conforme mostrado a seguir. Você pode se conectar ao seu armazenamento de configuração de aplicativo usando o Microsoft Entra ID (recomendado) ou uma cadeia de conexão.

    O DefaultAzureCredential é usado para autenticar no repositório de Configuração de Aplicativos por padrão. Siga as instruções para atribuir à credencial a função Leitor de Dados de Configuração de Aplicativo. Certifique-se de permitir tempo suficiente para a permissão se propagar antes de executar seu aplicativo.

    <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" endpoint="${Endpoint}" 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="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
</appSettings>

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

  3. 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

  1. Defina uma variável de ambiente.

    Defina a variável de ambiente chamada Ponto de Extremidade para o ponto de extremidade do repositório de Configuração de Aplicativos encontrado na Visão Geral do seu repositório no portal do Azure.

    Se você usar o prompt de comando do Windows, execute o comando a seguir e reinicie o prompt de comando para permitir que a alteração entre em vigor:

    setx Endpoint "<endpoint-of-your-app-configuration-store>"

    Se você usar o PowerShell, execute o seguinte comando:

    $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"

    Se você usa macOS ou Linux, execute o comando a seguir:

    export Endpoint='<endpoint-of-your-app-configuration-store>'

  2. Reinicie o Visual Studio para permitir que a alteração tenha efeito.

  3. 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.

  1. Entre no portal do Azure e selecione Grupos de recursos.
  2. Na caixa Filtrar por nome..., digite o nome do seu grupo de recursos.
  3. Na lista de resultados, selecione o nome do grupo de recursos para conferir uma visão geral.
  4. Selecione Excluir grupo de recursos.
  5. 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