.net 6 Console App Appsettings.json Environment

4 min read Jun 03, 2024

.net 6 Console App Appsettings.json Environment

Développez des applications console .NET 6 avec des configurations environnementales

Les applications console .NET 6 sont un excellent moyen de créer des outils de ligne de commande puissants et flexibles. Une fonctionnalité clé pour les applications robustes est la possibilité de personnaliser le comportement en fonction de l'environnement d'exécution. appsettings.json et les variables d'environnement fournissent une méthode pratique pour gérer les configurations spécifiques à l'environnement.

Configurer les paramètres de l'application avec appsettings.json

appsettings.json est un fichier JSON utilisé pour stocker les paramètres de l'application. Il est possible de créer des fichiers de configuration distincts pour chaque environnement, par exemple appsettings.Development.json, appsettings.Staging.json et appsettings.Production.json.

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "ConnectionStrings": {
    "DefaultConnection": "Server=myServer;Database=myDatabase;User Id=myUser;Password=myPassword"
  }
}

Ce fichier définit des paramètres tels que le niveau de journalisation et les chaînes de connexion à la base de données. Les valeurs dans appsettings.json sont chargées dans l'application par défaut, mais peuvent être remplacées par des variables d'environnement.

Priorité des variables d'environnement

Les variables d'environnement ont une priorité plus élevée que les paramètres dans appsettings.json. Cela signifie que les valeurs définies dans les variables d'environnement écraseront les valeurs correspondantes dans le fichier de configuration.

Pour utiliser les variables d'environnement, prefixez le nom de la configuration dans appsettings.json par "__" (deux underscores). Par exemple, pour modifier le niveau de journalisation par défaut, définissez la variable d'environnement "__Logging:LogLevel:Default" sur "Warning".

Charger les paramètres dans l'application

Pour charger les paramètres dans l'application, injectez l'instance de IConfiguration dans le constructeur de votre classe de programme.

public class Program
{
    private readonly IConfiguration _configuration;

    public Program(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        // Charger les paramètres
        builder.Services.AddConfiguration();

        var app = builder.Build();

        // Accéder aux paramètres
        var connectionString = _configuration.GetConnectionString("DefaultConnection");
        var logLevel = _configuration.GetValue("Logging:LogLevel:Default");

        // ...
    }
}

Conclusion

Utiliser appsettings.json et les variables d'environnement permet de créer des applications .NET 6 console flexibles et adaptables à différents environnements. En utilisant ces mécanismes de configuration, vous pouvez facilement gérer les paramètres de l'application, les chaînes de connexion et autres configurations sensibles à l'environnement. Cela permet d'améliorer la maintenabilité et la robustesse de votre code.

N'oubliez pas de prioriser les variables d'environnement pour écraser les valeurs définies dans appsettings.json, afin de garantir une configuration cohérente et une meilleure gestion des environnements.