Démarrage rapide : ajouter des indicateurs de fonctionnalité à une application console .NET/.NET Framework

Dans ce guide de démarrage rapide, vous incorporez Azure App Configuration dans une application console .NET ou .NET Framework pour créer une implémentation de bout en bout de la gestion des fonctionnalités. Vous pouvez utiliser App Configuration pour stocker de manière centralisée vos indicateurs de fonctionnalités et contrôler leur état.

Les bibliothèques de gestion des fonctionnalités .NET étendent .NET en fournissant la prise en charge des indicateurs de fonctionnalité. Ces bibliothèques sont basées sur le système de configuration de .NET. Elles s’intègrent à App Configuration par le biais de son fournisseur de configuration .NET.

Prérequis

• Compte Azure avec un abonnement actif. Créez-en un gratuitement.
• Un magasin App Configuration, comme illustré dans le guide de démarrage rapide pour la création d’un magasin.
• Visual Studio.
• Sdk .NET 8.0 ou version ultérieure pour une application console .NET.
• .NET Framework 4.7.2 ou version ultérieure pour une application console .NET Framework.

Ajouter un indicateur de fonctionnalité

Ajoutez un indicateur de fonctionnalité appelé Bêta au magasin App Configuration et laissez les valeurs par défaut à Étiquette et à Description. Pour plus d’informations sur l’ajout d’indicateurs de fonctionnalité à un magasin à l’aide du portail Azure ou d’Azure CLI, consultez Créer un indicateur de fonctionnalité.

Configurer les paramètres d’accès

L’application que vous créez dans ce guide de démarrage rapide se connecte à votre magasin App Configuration pour accéder à vos paramètres d’indicateur de fonctionnalité. Pour vous connecter à App Configuration, votre application peut utiliser l’ID Microsoft Entra ou une chaîne de connexion. Microsoft Entra ID est l’approche recommandée.

Créer une application console

Pour utiliser Visual Studio pour créer un projet d’application console, procédez comme suit.

1. Ouvrez Visual Studio. Si elle est déjà en cours d’exécution, fermez-la et rouvrez-la pour qu’elle reconnaisse la variable d’environnement que vous avez définie dans la section précédente.

2. Dans Visual Studio, sélectionnez Fichier>nouveau>projet.

3. Dans la boîte de dialogue Créer un projet, entrez Console dans la zone de recherche.

   • Si vous souhaitez créer une application .NET, sélectionnez Application console, puis Sélectionnez Suivant.
   • Si vous souhaitez créer une application .NET Framework, sélectionnez Application console (.NET Framework), puis Sélectionnez Suivant.

4. Dans la boîte de dialogue Configurer votre nouveau projet , entrez un nom de projet.

   • Si vous souhaitez créer une application .NET, sélectionnez Suivant pour ouvrir la boîte de dialogue Informations supplémentaires . Dans cette boîte de dialogue, sélectionnez un .NET Framework, décochez la case Ne pas utiliser les instructions de niveau supérieur , puis sélectionnez Créer.
   • Si vous souhaitez créer une application .NET Framework, sélectionnez .NET Framework 4.7.2 ou une version ultérieure sous Framework, puis sélectionnez Créer.

Utiliser l’indicateur de fonctionnalité

Pour utiliser l’indicateur de fonctionnalité dans votre application, procédez comme suit.

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis sélectionnez Gérer les packages NuGet.

2. Sous l’onglet Parcourir, recherchez et ajoutez les dernières versions stables des packages NuGet suivants à votre projet :

   • Microsoft Entra ID (recommandé)
   • Chaîne de connexion

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

3. Ouvrez Program.cs et ajoutez les instructions suivantes au début du fichier.

   • Microsoft Entra ID (recommandé)
   • Chaîne de connexion

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

4. Comme indiqué dans les blocs de code suivants, mettez à jour Program.cs en apportant trois modifications :

   • Pour charger des indicateurs de fonctionnalité à partir d’App Configuration, ajoutez un appel à la UseFeatureFlags méthode.
   • Pour lire les indicateurs de fonctionnalité à partir de la configuration, créez une instance de FeatureManager.
   • Affichez un message si l’indicateur de fonctionnalité bêta est activé.
   • Microsoft Entra ID (recommandé)
   • Chaîne de connexion

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

Générer et exécuter l’application localement

1. Dans Visual Studio, sélectionnez Ctrl+F5 pour générer et exécuter l’application. La sortie suivante doit apparaître dans la console.

   

2. Connectez-vous au portail Azure. Sélectionnez Toutes les ressources, puis sélectionnez votre magasin App Configuration.

3. Sélectionnez Gestionnaire de fonctionnalités et recherchez l’indicateur de fonctionnalité Beta. Activez l'interrupteur Activé pour activer le drapeau.

4. Exécutez de nouveau l'application. Le message bêta doit apparaître dans la console.

   

Nettoyer les ressources

Si vous ne souhaitez plus utiliser les ressources créées dans cet article, supprimez le groupe de ressources que vous avez créé ici afin d’éviter des frais.

1. Connectez-vous au portail Azure, puis sélectionnez Groupes de ressources.
2. Dans la zone Filtrer par nom, entrez le nom de votre groupe de ressources.
3. Dans la liste de résultats, sélectionnez le nom du groupe de ressources pour afficher une vue d’ensemble.
4. Sélectionnez Supprimer le groupe de ressources.
5. Vous êtes invité à confirmer la suppression du groupe de ressources. Entrez le nom de votre groupe de ressources à confirmer, puis sélectionnez Supprimer.

Après quelques instants, le groupe de ressources et toutes ses ressources sont supprimés.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé un indicateur de fonctionnalité dans App Configuration et vous l’avez utilisé avec une application console. Pour savoir comment mettre à jour dynamiquement les indicateurs de fonctionnalités et d’autres valeurs de configuration sans redémarrer l’application, consultez les didacticiels suivants :

Pour activer la fonctionnalité de gestion des fonctionnalités pour d’autres types d’applications, consultez les guides de démarrage rapide suivants :

Pour connaître l’exécution complète des fonctionnalités de la bibliothèque de gestion des fonctionnalités .NET, consultez le document suivant :