Partilhar via

Guia de início rápido: adicionar sinalizadores de recursos a um aplicativo de console do .NET/.NET Framework

Neste início rápido, você incorpora a Configuração do Aplicativo 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 do Aplicativo para armazenar centralmente todos os seus sinalizadores de recursos e controlar seus estados.

As bibliotecas de gerenciamento de recursos do .NET estendem o .NET fornecendo suporte ao sinalizador de recursos. Essas bibliotecas são criadas sobre o sistema de configuração .NET. Eles se integram à Configuração de Aplicativos por meio de seu provedor de configuração .NET.

Pré-requisitos

Adicionar um sinalizador de recurso

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

Captura de tela da caixa de diálogo Criar um novo sinalizador de recurso no portal do Azure. Os campos de nome e chave contêm Beta. O rótulo e a descrição estão em branco.

Definir definições de acesso

A aplicação que cria nesta introdução rápida liga-se à sua loja de configuração de aplicações para aceder às configurações do sinalizador de funcionalidades. Para se conectar à Configuração do Aplicativo, seu aplicativo pode usar a ID do Microsoft Entra ou uma cadeia de conexão. Microsoft Entra ID é a abordagem recomendada.

Atribuir uma função de dados de Configuração de Aplicativo

Por padrão, o aplicativo que você cria usa DefaultAzureCredential para autenticar em sua loja de configuração de aplicativos. DefaultAzureCredential é uma cadeia de credenciais de token. Para que a autorização funcione, você precisa conceder a função Leitor de Dados de Configuração do Aplicativo à credencial usada pelo aplicativo. Para obter instruções, consulte Autenticação com credenciais de token. Permita tempo suficiente para que a atribuição de função se propague antes de executar seu aplicativo.

Definir uma variável de ambiente

Seu aplicativo usa uma variável de ambiente para estabelecer a conexão com a Configuração do aplicativo. Use um dos comandos a seguir para definir uma variável de ambiente nomeada Endpoint para o ponto de extremidade da sua loja de Configuração de Aplicativos.

  • Se você usar o prompt de comando, execute o seguinte comando:

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

    Feche e reabra o prompt de comando para que a alteração entre em vigor. Verifique se a variável de ambiente está definida imprimindo seu valor no console.

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

    [System.Environment]::SetEnvironmentVariable("Endpoint", "<endpoint-of-your-app-configuration-store>", "User")

Criar uma aplicação de consola

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 já estiver em execução, feche-o e abra-o novamente para que ele reconheça 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, em seguida, selecione Avançar.
    • Se você quiser criar um aplicativo .NET Framework, selecione Aplicativo de Console (.NET Framework) e, em seguida, 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 um .NET framework, 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 em Framework e, em seguida, selecione Criar.

Usar o sinalizador de recurso

Para usar o sinalizador de recurso em seu aplicativo, siga as etapas a seguir.

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

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

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

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

    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 do aplicativo, adicione uma chamada ao UseFeatureFlags método.
    • Para ler sinalizadores de recursos da configuração, crie uma instância do FeatureManager.
    • Exiba uma mensagem se o sinalizador de recurso Beta estiver habilitado.

    .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!");
}

Crie e execute o aplicativo localmente

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

    Captura de ecrã de uma janela da Linha de Comandos que contém a saída da aplicação. A saída contém o texto Hello World!

  2. Inicie sessão no portal do Azure. Selecione Todos os recursos e, em seguida, selecione a sua loja de Configuração de Aplicações.

  3. Selecione Gerenciador de recursos e localize o sinalizador de recursos Beta . Ative a alternância Ativado para ativar o sinalizador.

  4. Execute novamente a aplicação. A mensagem Beta deve aparecer no console.

    Captura de ecrã de uma janela da Linha de Comandos que contém a saída da aplicação. A saída contém o texto Bem-vindo à versão beta! e Olá Mundo!

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.

  1. Entre no portal do Azure e selecione Grupos de recursos.
  2. Na caixa Filtrar por nome, introduza o nome do seu grupo de recursos.
  3. Na lista de resultados, selecione o nome do grupo de recursos para ver uma visão geral.
  4. Selecione Eliminar grupo de recursos.
  5. É-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 um sinalizador de recurso na Configuração do Aplicativo e o usou com um aplicativo de console. Para saber como atualizar dinamicamente sinalizadores de recursos e outros valores de configuração sem reiniciar o aplicativo, consulte os seguintes tutoriais:

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

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

Para habilitar a capacidade de gerenciamento de funcionalidades para outros tipos de aplicativos, consulte os seguintes guias de início rápido:

Adicionar sinalizadores de recursos a um aplicativo ASP.NET Core

Adicionar sinalizadores de recursos a um serviço em segundo plano do .NET

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

Gerenciamento de recursos .NET

  • Last updated on