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

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

Pré-requisitos

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

  1. Para criar um novo repositório de Configurações de Aplicativo, entre no portal do Azure. No canto superior esquerdo da Página Inicial, selecione Criar um recurso. Na caixa Pesquisar no Marketplace, insira Configuração de Aplicativos e selecione Enter.

    Pesquisar a Configuração de Aplicativo

  2. Selecione Configuração de Aplicativo nos resultados da pesquisa e, em seguida, selecione Criar.

    Selecione Criar

  3. No painel Criar Configuração de Aplicativos, insira as configurações a seguir:

    Configuração Valor sugerido Descrição
    Assinatura Sua assinatura Selecione a assinatura do Azure que deseja usar para testar a Configuração de Aplicativo. Se a conta tiver apenas uma assinatura, ela será selecionada automaticamente e a lista Assinatura não será exibida.
    Grupo de recursos AppConfigTestResources Selecione ou crie um grupo de recursos para o recurso do repositório de Configurações de Aplicativo. Esse grupo é útil para organizar vários recursos que você pode querer excluir ao mesmo tempo, excluindo o grupo de recursos. Para saber mais, veja Usar os grupos de recursos para gerenciar seus recursos do Azure.
    Nome do recurso Nome globalmente exclusivo Insira um nome exclusivo do recurso a ser usado para o recurso do repositório de Configurações de Aplicativo. O nome deve ser uma cadeia de 5 a 50 caracteres e deve conter somente números, letras e o caractere -. O nome não pode começar nem terminar com o caractere -.
    Localidade Centro dos EUA Use Localização para especificar a localização geográfica na qual o repositório de configurações de aplicativo está hospedado. Para obter o melhor desempenho, crie o recurso na mesma região que outros componentes do aplicativo.
    Tipo de preços Gratuito Selecione o tipo de preço desejado. Para obter mais informações, confira a página de preços da Configuração de Aplicativos.
  4. Selecione Examinar + criar para validar suas configurações.

  5. Selecione Criar. A implantação pode levar alguns minutos.

  6. Após a conclusão da implantação, navegue até o recurso de Configuração de Aplicativos. Selecione Configurações > Chaves de acesso. Anote a cadeia de conexão de chave somente leitura primária. Você usará essa cadeia de conexão posteriormente para configurar o aplicativo a comunicar-se com o repositório de Configurações de Aplicativo que você criou.

  1. Selecione Gerenciador de Configurações > Criar > Chave-valor para adicionar os seguintes pares chave-valor:

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

    Deixe Rótulo e Tipo de Conteúdo vazios por enquanto.

  2. Escolha Aplicar.

Criar um aplicativo de console do .NET

  1. Inicie o Visual Studio e selecione Arquivo > Novo > Projeto.

  2. Em Criar um projeto, filtre o tipo de projeto Console e clique em Aplicativo de Console (.NET Framework) . Selecione Avançar.

  3. Em Configurar seu novo projeto, insira um nome de projeto. Em Framework, selecione .NET Framework 4.7.1 ou superior. Selecione Criar.

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

  1. 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 1.0.0 or later
    Microsoft.Configuration.ConfigurationBuilders.Environment 2.0.0 or later
    System.Configuration.ConfigurationManager version 4.6.0 or later
    
  2. 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.

  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 localmente

  1. Atualize o arquivo App.config substituindo ${ConnectionString} pela cadeia de conexão real da sua instância de Configuração de Aplicativo. Encontre-o na guia Chaves de acesso do recurso Configuração de Aplicativo no portal do Azure.

  2. Pressione Ctrl + F5 para criar e executar o aplicativo do 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. O valor AppSettings de ConfigurationManager não será alterado depois que o aplicativo for iniciado. No entanto, a biblioteca do provedor de configuração do .NET Standard da Configuração de Aplicativos também pode ser usada em um aplicativo .NET Framework. Para saber como permitir que o aplicativo .NET Framework atualize dinamicamente configurações, passe para o próximo tutorial.