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

Artigo
07/17/2024

Neste início rápido, você incorporará a Configuração de Aplicativos do Azure a um aplicativo de console .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 do Gerenciamento de Recursos do .NET estendem a estrutura com suporte a sinalizadores de recursos. 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. Crie um repositório.
Visual Studio
SDK do .NET 6.0 ou posterior para aplicativos de console do .NET.
.NET Framework 4.7.2 ou posterior para aplicativos de console do .NET Framework.

Adicionar um sinalizador de recursos

Adicione um sinalizador de recurso 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 mais informações sobre como adicionar sinalizadores de recursos a um repositório usando o portal do Azure ou a CLI, acesse Criar um sinalizador de recurso.

Criar um aplicativo de console

Você pode usar o Visual Studio para criar um novo projeto de aplicativo de console.

Inicie o Visual Studio e selecione Arquivo>Novo>Projeto.
Em Criar um novo projeto, filtre Console no tipo de projeto e selecione Aplicativo de Console. Se você quiser criar um aplicativo .NET Framework, selecione Aplicativo de Console (.NET Framework). Clique em Avançar.
Em Configurar seu novo projeto, insira um nome de projeto. Se você estiver criando um aplicativo .NET Framework, selecione .NET Framework 4.7.2 ou superior em Framework. Clique em Criar.

Usar o sinalizador de recurso

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.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement
```
Verifique se a versão de Microsoft.FeatureManagement é maior que 3.1.0.

Abra Program.cs e adicione as instruções a seguir.

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

Conecte-se à Configuração de Aplicativos especificando a opção UseFeatureFlags para que os sinalizadores de recursos sejam recuperados. Crie um ConfigurationFeatureDefinitionProvider para fornecer a definição de sinalizador de recurso da configuração e FeatureManager para avaliar o estado dos sinalizadores de recursos. Em seguida, exiba uma mensagem se o sinalizador de recursos Beta estiver habilitado.

.NET
.NET Framework

IConfiguration configuration = new ConfigurationBuilder()
    .AddAzureAppConfiguration(options =>
    {
        options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
            .UseFeatureFlags();
    }).Build();

IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);

IFeatureManager featureManager = new FeatureManager(
    featureDefinitionProvider, 
    new FeatureManagementOptions());

if (await featureManager.IsEnabledAsync("Beta"))
{
    Console.WriteLine("Welcome to the beta!");
}

Console.WriteLine("Hello World!");

public static async Task Main(string[] args)
{         
    IConfiguration configuration = new ConfigurationBuilder()
        .AddAzureAppConfiguration(options =>
        {
            options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                .UseFeatureFlags();
        }).Build();

    IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);

    IFeatureManager featureManager = new FeatureManager(
        featureDefinitionProvider, 
        new FeatureManagementOptions());

    if (await featureManager.IsEnabledAsync("Beta"))
    {
        Console.WriteLine("Welcome to the beta!");
    }

    Console.WriteLine("Hello World!");
}

Compilar e executar o aplicativo localmente

Defina uma variável de ambiente chamada ConnectionString como a cadeia de conexão do repositório de Configuração de Aplicativos.
- Prompt de comando do Windows
- PowerShell
Se você usar o prompt de comando do Windows, execute o comando a seguir.
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Reinicie o prompt de comando para permitir que a alteração entre em vigor. Imprima o valor da variável de ambiente para validar que ele está definido corretamente.
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 compilar e executar o aplicativo.
Você deve ver as seguintes saídas no console.
Entre no portal do Azure. Escolha Todos os recursos e escolha o repositório de Configuração de Aplicativos que você criou anteriormente.
Selecione Gerenciador de recursos e localize o sinalizador de recurso Beta. Habilite o sinalizador marcando a caixa de seleção abaixo de Habilitado.
Execute o aplicativo novamente. Você deve ver a mensagem Beta 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 sinalizador de recursos na Configuração de Aplicativos e o usou com um aplicativo de console. Para saber como atualizar dinamicamente os sinalizadores de recursos e outros valores de configuração sem reiniciar o aplicativo, passe para o próximo tutorial.

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

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

Para habilitar a funcionalidade de gerenciamento de recursos em outros tipos de aplicativos, continue nos tutoriais a seguir.

Usar sinalizadores de recursos em aplicativos ASP.NET Core

Usar sinalizadores de recursos em serviços em segundo plano do .NET

Para obter o resumo completo dos recursos da biblioteca de gerenciamento de recursos .NET, continue para o documento a seguir.

Gerenciamento de recursos .NET