Démarrage rapide : Créer une application .NET Framework avec Azure App Configuration

Article
05/24/2024

Il existe deux façons d’incorporer Azure App Configuration dans une application .NET Framework.

Le générateur de configuration pour App Configuration permet de charger des données à partir d’App Configuration dans les paramètres de l’application. Votre application accède à la configuration comme elle le fait toujours via ConfigurationManager. Vous n’avez pas besoin d’apporter de changements au code autres que les mises à jour des fichiers app.config ou web.config. Ce guide de démarrage rapide vous guidera tout au long de cette option.
Comme conçu par le .NET Framework, les paramètres de l’application ne peuvent être actualisés que lors du redémarrage de l’application. Le fournisseur .NET d’App Configuration est une bibliothèque .NET Standard. Il prend en charge la mise en cache et l’actualisation dynamiques de la configuration sans redémarrage de l’application. Si la configuration dynamique est essentielle pour vous et que vous êtes disposé à apporter des changements au code, consultez les tutoriels sur la façon dont vous pouvez implémenter des mises à jour de configuration dynamiques dans une application console .NET Framework ou une application web ASP.NET.

Dans ce guide de démarrage rapide, une application console .NET Framework est utilisée comme exemple, mais la même technique s’applique à une application ASP.NET Web Forms/MVC.

Prérequis

Compte Azure avec un abonnement actif. Créez-en un gratuitement.
Un magasin App Configuration. Créez un magasin.
Visual Studio
.NET Framework 4.7.2 ou version ultérieure

Ajouter une clé-valeur

Ajoutez la clé-valeur suivante au magasin App Configuration et laissez les valeurs par défaut pour Étiquette et Type de contenu. Pour plus d’informations sur l’ajout de clés-valeurs à un magasin avec le Portail Azure ou la CLI, consultez Créer une clé-valeur.

Clé	Valeur
TestApp:Settings:Message	Data from Azure App Configuration

Créer une application console .NET Framework

Démarrez Visual Studio et sélectionnez Créer un projet.
Dans Créer un projet, filtrez sur le type de projet Console et sélectionnez Application console (.NET Framework) avec C# dans la liste de modèles de projet. Appuyez sur Suivant.
Dans Configurer votre nouveau projet , entrez un nom de projet. Sous Framework, sélectionnez .NET Framework 4.7.2 ou une version ultérieure. Appuyez sur Créer.

Se connecter à un magasin App Configuration

Cliquez avec le bouton droit sur votre projet, puis sélectionnez Gérer les packages NuGet. Sous l’onglet Parcourir, recherchez et ajoutez les packages NuGet suivants à votre projet.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration version 1.0.0 ou ultérieure
- Microsoft.Configuration.ConfigurationBuilders.Environment version 2.0.0 ou ultérieure
- System.Configuration.ConfigurationManager version 4.6.0 ou ultérieure

Mettez à jour le fichier App.config de votre projet comme suit :

<configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
</configSections>

<configBuilders>
    <builders>
        <add name="MyConfigStore" mode="Greedy" connectionString="${ConnectionString}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
        <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
</configBuilders>

<appSettings configBuilders="Environment,MyConfigStore">
    <add key="AppName" value="Console App Demo" />
    <add key="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
</appSettings>

La chaîne de connexion de votre magasin App Configuration est lue à partir de la variable d’environnement ConnectionString. Ajoutez le générateur de configuration Environment avant MyConfigStore dans la propriété configBuilders à la section appSettings.

Ouvrez Program.cs, puis mettez à jour la méthode Main pour utiliser App Configuration en appelant ConfigurationManager.

static void Main(string[] args)
{
    string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];

    Console.WriteLine(message);
    Console.ReadKey();
}

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

Définissez une variable d’environnement nommée ConnectionString sur la chaîne de connexion de la clé en lecture seule obtenue lors de la création du magasin App Configuration.

Si vous utilisez l’invite de commandes Windows, exécutez la commande suivante :
```
setx ConnectionString "<connection-string-of-your-app-configuration-store>"
```
Si vous utilisez Windows PowerShell, exécutez la commande suivante :
```
$Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
```
Redémarrez Visual Studio pour que la modification soit prise en compte.
Appuyez sur Ctrl + F5 pour générer et exécuter l’application console. Vous devez voir le message généré par les sorties App Configuration 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.

Important

La suppression d’un groupe de ressources est irréversible. Le groupe de ressources et toutes les ressources qu’il contient sont supprimés définitivement. Veillez à ne pas supprimer accidentellement les mauvaises ressources ou le mauvais groupe de ressources. Si vous avez créé les ressources pour cet article dans un groupe de ressources contenant d’autres ressources que vous souhaitez conserver, supprimez chaque ressource individuellement à partir de son volet, au lieu de supprimer l’intégralité du groupe de ressources.

Connectez-vous au portail Azure, puis sélectionnez Groupes de ressources.
Dans la zone Filtrer par nom, entrez le nom de votre groupe de ressources.
Dans la liste de résultats, sélectionnez le nom du groupe de ressources pour afficher une vue d’ensemble.
Sélectionnez Supprimer le groupe de ressources.
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

En suivant ce guide de démarrage rapide, vous avez créé un magasin App Configuration et vous l’avez utilisé avec une application console .NET Framework. Pour savoir comment permettre à votre application .NET Framework d’actualiser dynamiquement les paramètres de configuration, passez aux tutoriels suivants.

Activer la configuration dynamique dans une application .NET Framework

Activer la configuration dynamique dans une application web ASP.NET

Partager via