Quickstart: Adicione bandeiras de recurso a uma aplicação .NET FrameworkQuickstart: Add feature flags to a .NET Framework app

Neste quickstart, incorpora a Configuração de Aplicações Azure numa aplicação .NET Framework para criar uma implementação de ponta a ponta da gestão de funcionalidades.In this quickstart, you incorporate Azure App Configuration into a .NET Framework app to create an end-to-end implementation of feature management. Pode utilizar o serviço de Configuração de Aplicações para armazenar centralmente todas as suas bandeiras de funcionalidades e controlar os seus estados.You can use the App Configuration service to centrally store all your feature flags and control their states.

As bibliotecas de Gestão de Recursos .NET alargam o quadro com suporte de bandeira de recurso.The .NET Feature Management libraries extend the framework with feature flag support. Estas bibliotecas são construídas em cima do sistema de configuração .NET.These libraries are built on top of the .NET configuration system. Integram-se com a Configuração de Aplicações através do seu fornecedor de configuração .NET.They integrate with App Configuration through its .NET configuration provider.

Pré-requisitosPrerequisites

Criar uma loja de configuração de aplicativosCreate an App Configuration store

  1. Para criar uma nova loja de Configuração de Aplicações, inscreva-se no portal Azure.To create a new App Configuration store, sign in to the Azure portal. No canto superior esquerdo da página inicial, selecione Criar um recurso.In the upper-left corner of the home page, select Create a resource. Na caixa 'Pesquisar o Mercado', insira a Configuração da Aplicação e selecione Enter.In the Search the Marketplace box, enter App Configuration and select Enter.

    Pesquisa rumo à Configuração de Aplicações

  2. Selecione a Configuração da Aplicação a partir dos resultados da pesquisa e, em seguida, selecione Criar.Select App Configuration from the search results, and then select Create.

    Selecione Criar

  3. No painel de configuração da aplicação Criar, insira as seguintes definições:On the Create App Configuration pane, enter the following settings:

    DefiniçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    SubscriçãoSubscription A sua subscriçãoYour subscription Selecione a subscrição Azure que pretende utilizar para testar a Configuração da Aplicação.Select the Azure subscription that you want to use to test App Configuration. Se a sua conta tiver apenas uma subscrição, é selecionada automaticamente e a lista de Subscrição não é apresentada.If your account has only one subscription, it's automatically selected and the Subscription list isn't displayed.
    Grupo de recursosResource group AppConfigTestResourcesAppConfigTestResources Selecione ou crie um grupo de recursos para o seu recurso de loja de configuração de aplicações.Select or create a resource group for your App Configuration store resource. Este grupo é útil para organizar múltiplos recursos que você pode querer eliminar ao mesmo tempo, eliminando o grupo de recursos.This group is useful for organizing multiple resources that you might want to delete at the same time by deleting the resource group. Para obter mais informações, veja Utilizar grupos de recursos para gerir os recursos do Azure.For more information, see Use resource groups to manage your Azure resources.
    Nome de recursoResource name Nome globalmente exclusivoGlobally unique name Introduza um nome de recurso único para usar para o recurso da loja de configuração de aplicações.Enter a unique resource name to use for the App Configuration store resource. O nome deve ser uma corda entre 5 e 50 caracteres e conter apenas números, letras e o - personagem.The name must be a string between 5 and 50 characters and contain only numbers, letters, and the - character. O nome não pode começar ou terminar com o - personagem.The name can't start or end with the - character.
    LocalizaçãoLocation E.U.A. CentralCentral US Utilize a Localização para especificar a localização geográfica em que a sua loja de configuração de aplicações está hospedada.Use Location to specify the geographic location in which your app configuration store is hosted. Para obter o melhor desempenho, crie o recurso na mesma região que outros componentes da sua aplicação.For the best performance, create the resource in the same region as other components of your application.
    Escalão de preçoPricing tier GratuitoFree Selecione o nível de preços pretendido.Select the desired pricing tier. Para obter mais informações, consulte a página de preços de Configuração da Aplicação.For more information, see the App Configuration pricing page.
  4. Selecione Rever + criar para validar as suas definições.Select Review + create to validate your settings.

  5. Selecione Criar.Select Create. A implantação pode demorar alguns minutos.The deployment might take a few minutes.

  6. Após o fim da implementação, navegue para o recurso de Configuração da Aplicação.After the deployment finishes, navigate to the App Configuration resource. Selecione Definições > Chaves de acesso.Select Settings > Access keys. Tome nota da ligação principal apenas para leitura.Make a note of the primary read-only key connection string. Utilizará esta cadeia de ligação mais tarde para configurar a sua aplicação para comunicar com a loja de Configuração de Aplicações que criou.You'll use this connection string later to configure your application to communicate with the App Configuration store that you created.

  1. Selecione Feature Manager > +Adicione para adicionar uma bandeira de recurso chamada Beta .Select Feature Manager > +Add to add a feature flag called Beta.

    Ativar a bandeira de recurso chamada BetaEnable feature flag named Beta

    Deixe label indefinida por enquanto.Leave label undefined for now.

Criar uma aplicação de consola .NETCreate a .NET console app

  1. Inicie o Estúdio Visual e selecione File > New > Project.Start Visual Studio, and select File > New > Project.

  2. In Create a new project, filter on the Console project type and click on Console App (.NET Framework).In Create a new project, filter on the Console project type and click on Console App (.NET Framework). Clique em Seguinte.Click Next.

  3. Em Configurar o seu novo projeto, insira um nome de projeto.In Configure your new project, enter a project name. No quadro, selecione .NET Framework 4.8 ou superior.Under Framework, select .NET Framework 4.8 or higher. Clique em Criar.Click Create.

Conecte-se a uma loja de configuração de aplicativosConnect to an App Configuration store

  1. Clique com o botão direito no seu projeto e selecione Gerir Pacotes NuGet.Right-click your project, and select Manage NuGet Packages. No separador Procurar, procure e adicione os seguintes pacotes NuGet ao seu projeto.On the Browse tab, search and add the following NuGet packages to your project. Se não conseguir encontrá-los, selecione a caixa de verificação "Incluir pré-relançar".If you can't find them, select the Include prerelease check box.

    Microsoft.Extensions.DependencyInjection
    Microsoft.Extensions.Configuration.AzureAppConfiguration
    Microsoft.FeatureManagement
    
  2. Programa Aberto.cs e adicione as seguintes declarações:Open Program.cs and add the following statements:

    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    using Microsoft.FeatureManagement;
    using System.Threading.Tasks;
    
  3. Atualize o Main método para ligar à Configuração da Aplicação, especificando a UseFeatureFlags opção para que as bandeiras de recurso sejam recuperadas.Update the Main method to connect to App Configuration, specifying the UseFeatureFlags option so that feature flags are retrieved. Em seguida, apresente uma mensagem se a bandeira de Beta funcionalidade estiver ativada.Then display a message if the Beta feature flag is enabled.

        public static async Task Main(string[] args)
        {         
            IConfigurationRoot configuration = new ConfigurationBuilder()
                .AddAzureAppConfiguration(options =>
                {
                    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                           .UseFeatureFlags();
                }).Build();
    
            IServiceCollection services = new ServiceCollection();
    
            services.AddSingleton<IConfiguration>(configuration).AddFeatureManagement();
    
            using (ServiceProvider serviceProvider = services.BuildServiceProvider())
            {
                IFeatureManager featureManager = serviceProvider.GetRequiredService<IFeatureManager>();
    
                if (await featureManager.IsEnabledAsync("Beta"))
                {
                    Console.WriteLine("Welcome to the beta!");
                }
            }
    
            Console.WriteLine("Hello World!");
            Console.WriteLine("Press any key to continue ...");
            Console.Read();
        }
    

Construa e execute a app localmenteBuild and run the app locally

  1. Desaprova uma variável ambiental chamada ConnectionString para a cadeia de ligação da sua loja de Configuração de Aplicações.Set an environment variable named ConnectionString to the connection string of your App Configuration store. Se utilizar o pedido de comando do Windows, execute o seguinte comando:If you use the Windows command prompt, run the following command:

        setx ConnectionString "connection-string-of-your-app-configuration-store"
    

    Se utilizar o Windows PowerShell, executar o seguinte comando:If you use Windows PowerShell, run the following command:

        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    
  2. Reinicie o Estúdio Visual para permitir que a alteração entre em vigor.Restart Visual Studio to allow the change to take effect.

  3. Prima Ctrl + F5 para construir e executar a aplicação da consola.Press Ctrl + F5 to build and run the console app.

    App com bandeira de recurso ativada

Limpar os recursosClean up resources

Se não quiser continuar a utilizar os recursos criados neste artigo, elimine o grupo de recursos que criou aqui para evitar encargos.If you do not want to continue using the resources created in this article, delete the resource group you created here to avoid charges.

Importante

A eliminação de um grupo de recursos é irreversível.Deleting a resource group is irreversible. O grupo de recursos e todos os recursos nele nele são permanentemente eliminados.The resource group and all the resources in it are permanently deleted. Confirme que não elimina acidentalmente o grupo de recursos ou recursos errados.Make sure that you don't accidentally delete the wrong resource group or resources. Se criou os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que pretende manter, elimine cada recurso individualmente do seu respetivo painel em vez de eliminar o grupo de recursos.If you created the resources for this article inside a resource group that contains other resources you want to keep, delete each resource individually from its respective pane instead of deleting the resource group.

  1. Inscreva-se no portal Azuree selecione grupos de Recursos.Sign in to the Azure portal, and select Resource groups.
  2. Na caixa de identificação filter by name, insira o nome do seu grupo de recursos.In the Filter by name box, enter the name of your resource group.
  3. Na lista de resultados, selecione o nome do grupo de recursos para ver uma visão geral.In the result list, select the resource group name to see an overview.
  4. Selecione Eliminar grupo de recursos.Select Delete resource group.
  5. É-lhe pedido que confirme a eliminação do grupo de recursos.You're asked to confirm the deletion of the resource group. Introduza o nome do seu grupo de recursos para confirmar e selecione Delete.Enter the name of your resource group to confirm, and select Delete.

Após alguns momentos, o grupo de recursos e todos os seus recursos são eliminados.After a few moments, the resource group and all its resources are deleted.

Passos seguintesNext steps

Neste arranque rápido, criou uma bandeira de recurso na Configuração de Aplicações e utilizou-a com uma aplicação de consola .NET Framework.In this quickstart, you created a feature flag in App Configuration and used it with a .NET Framework console app. Para aprender a atualizar dinamicamente as bandeiras de funcionalidades e outros valores de configuração sem reiniciar a aplicação, continue para o próximo tutorial.To learn how to dynamically update feature flags and other configuration values without restarting the application, continue to the next tutorial.