Início Rápido: adicionar sinalizadores de recursos a um aplicativo de console do .NET/.NET Framework

Neste início rápido, você incorporará a Configuração de Aplicativos do Azure em um aplicativo de console .NET ou .NET Framework para criar uma implementação de ponta a ponta do gerenciamento de recursos. Você pode usar a Configuração de Aplicativos para armazenar centralmente todos os sinalizadores de recursos e controlar seus estados.

As bibliotecas de gerenciamento de recursos do .NET estendem o .NET fornecendo suporte ao sinalizador de recurso. Essas bibliotecas se baseiam no sistema de configuração do .NET. Elas são integradas à Configuração de Aplicativos por meio do provedor de configuração do .NET.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
• Um repositório de Configuração de Aplicativos, conforme mostrado no início rápido para a criação de um repositório.
• Visual Studio.
• SDK do .NET 8.0 ou posterior para um aplicativo de console do .NET.
• .NET Framework 4.7.2 ou posterior para um aplicativo de console do .NET Framework.

Adicionar um sinalizador de recursos

Adicione um sinalizador de recursos chamado Beta ao repositório da Configuração de Aplicativos e deixe o Rótulo e a Descrição com seus valores padrão. Para obter mais informações sobre como adicionar sinalizadores de recursos a um repositório usando o portal do Azure ou a CLI do Azure, consulte Criar um sinalizador de recurso.

Definir configurações de acesso

O aplicativo criado neste início rápido conecta-se ao repositório da Configuração de Aplicativos para acessar as configurações do sinalizador de recursos. Para se conectar à Configuração de Aplicativos, seu aplicativo pode usar a ID do Microsoft Entra ou uma cadeia de conexão. A ID do Microsoft Entra é a abordagem recomendada.

Criar um aplicativo de console

Para usar o Visual Studio para criar um novo projeto de aplicativo de console, execute as etapas a seguir.

1. Abra o Visual Studio. Se ele já estiver em execução, feche-o e reabra-o para reconhecer a variável de ambiente definida na seção anterior.

2. No Visual Studio, selecione Arquivo>Novo>Projeto.

3. Na caixa de diálogo Criar um novo projeto , insira Console na caixa de pesquisa.

   • Se você quiser criar um aplicativo .NET, selecione Aplicativo de Console e selecione Avançar.
   • Se você quiser criar um aplicativo .NET Framework, selecione Aplicativo de Console (.NET Framework) e selecione Avançar.

4. Na caixa de diálogo Configurar seu novo projeto , insira um nome de projeto.

   • Se você quiser criar um aplicativo .NET, selecione Avançar para abrir a caixa de diálogo Informações Adicionais . Nessa caixa de diálogo, selecione uma estrutura do .NET, desmarque a caixa de seleção Não usar instruções de nível superior e selecione Criar.
   • Se você quiser criar um aplicativo .NET Framework, selecione .NET Framework 4.7.2 ou uma versão posterior no Framework e selecione Criar.

Usar o sinalizador de recurso

Para usar o sinalizador de recursos em seu aplicativo, execute as etapas a seguir.

1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes NuGet.

2. Na guia Procurar, pesquise e adicione as versões estáveis mais recentes dos seguintes pacotes NuGet ao seu projeto:

   • Microsoft Entra ID (recomendado)
   • Cadeia de conexão

   • Microsoft.Extensions.Configuration.AzureAppConfiguration
   • Microsoft.FeatureManagement
   • Azure.Identity

3. Abra Program.cs e adicione as instruções a seguir ao início do arquivo.

   • Microsoft Entra ID (recomendado)
   • Cadeia de conexão

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Microsoft.FeatureManagement;
   using Azure.Identity;
   

4. Conforme mostrado nos seguintes blocos de código, atualize Program.cs fazendo três alterações:

   • Para carregar sinalizadores de recursos da Configuração de Aplicativos, adicione uma chamada ao UseFeatureFlags método.
   • Para ler sinalizadores de recurso da configuração, crie uma instância do FeatureManager.
   • Exiba uma mensagem se o sinalizador de recurso Beta estiver habilitado.
   • Microsoft Entra ID (recomendado)
   • Cadeia de conexão

   .NET

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           string endpoint = Environment.GetEnvironmentVariable("Endpoint");
           options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                  .UseFeatureFlags();
       }).Build();
   
   var featureManager = new FeatureManager(
       new ConfigurationFeatureDefinitionProvider(configuration));
   
   if (await featureManager.IsEnabledAsync("Beta"))
   {
       Console.WriteLine("Welcome to the beta!");
   }
   
   Console.WriteLine("Hello World!");
   

   .NET Framework

   public static async Task Main(string[] args)
   {         
       IConfiguration configuration = new ConfigurationBuilder()
           .AddAzureAppConfiguration(options =>
           {
               string endpoint = Environment.GetEnvironmentVariable("Endpoint");
               options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                      .UseFeatureFlags();
           }).Build();
   
       var featureManager = new FeatureManager(
           new ConfigurationFeatureDefinitionProvider(configuration));
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

Compilar e executar o aplicativo localmente

1. No Visual Studio, selecione Ctrl+F5 para compilar e executar o aplicativo. A saída a seguir deve aparecer no console.

   

2. Entre no portal do Azure. Selecione Todos os recursos e selecione o repositório de Configuração de Aplicativos.

3. Selecione Gerenciador de recursos e localize o sinalizador de recurso Beta. Ative a alternância Habilitado para habilitar o sinalizador.

4. Execute o aplicativo novamente. A mensagem Beta deve aparecer 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.

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 sinalizador de recursos na Configuração de Aplicativos e o usou com um aplicativo de console. Para descobrir como atualizar dinamicamente os sinalizadores de recursos e outros valores de configuração sem reiniciar o aplicativo, consulte os seguintes tutoriais:

Para habilitar a funcionalidade de gerenciamento de recursos para outros tipos de aplicativos, confira os seguintes guias de início rápido:

Para obter o rundown completo de recursos da biblioteca de gerenciamento de recursos do .NET, consulte o seguinte documento: