Migrer la configuration vers ASP.NET Core

Dans l’article précédent, nous avons commencé à migrer un projet MVC ASP.NET vers ASP.NET Core MVC. Dans cet article, nous migreons la configuration.

Afficher ou télécharger un exemple de code (comment télécharger)

Configuration de l’installation

ASP.NET Core n’utilise plus les fichiers Global.asax et web.config que les versions précédentes de ASP.NET utilisées. Dans les versions antérieures de ASP.NET, la logique de démarrage de l’application a été placée dans une Application_StartUp méthode dans Global.asax. Plus tard, dans ASP.NET MVC, un Startup.cs fichier a été inclus à la racine du projet ; et il a été appelé au démarrage de l’application. ASP.NET Core a adopté cette approche complètement en plaçant toute la logique de démarrage dans le Startup.cs fichier.

Le fichier web.config a également été remplacé dans ASP.NET Core. La configuration elle-même peut désormais être configurée, dans le cadre de la procédure de démarrage de l’application décrite dans Startup.cs. La configuration peut toujours utiliser des fichiers XML, mais généralement ASP.NET projets Core place les valeurs de configuration dans un fichier au format JSON, tel que appsettings.json. ASP.NET système de configuration de Core peut également accéder facilement aux variables d’environnement, ce qui peut fournir un emplacement plus sécurisé et robuste pour les valeurs spécifiques à l’environnement. Cela est particulièrement vrai pour les secrets tels que les chaînes de connexion et les clés API qui ne doivent pas être vérifiées dans le contrôle de code source. Consultez Configuration pour en savoir plus sur la configuration dans ASP.NET Core.

Pour configurer la configuration, ajoutez le constructeur et la propriété suivants au fichier situé à la Startup.cs racine du projet :

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public IConfiguration Configuration { get; }

Notez qu’à ce stade, le Startup.cs fichier ne sera pas compilé, car nous devons quand même ajouter l’instruction suivante using :

using Microsoft.Extensions.Configuration;

Ajoutez un fichier appsettings.json à la racine du projet en utilisant le modèle d'élément approprié :

Migrer les paramètres de configuration à partir de web.config

Notre projet MVC ASP.NET incluait la chaîne de connexion de base de données requise dans web.config, dans l’élément <connectionStrings> . Dans notre projet ASP.NET Core, nous allons stocker ces informations dans le appsettings.json fichier. Ouvrez appsettings.jsonet notez qu’il inclut déjà les éléments suivants :

{
    "Data": {
        "DefaultConnection": {
            "ConnectionString": "Server=(localdb)\\MSSQLLocalDB;Database=_CHANGE_ME;Trusted_Connection=True;"
        }
    }
}

Dans la ligne mise en surbrillance illustrée ci-dessus, changez le nom de la base de données de _CHANGE_ME en remplaçant par le nom de votre base de données.

Summary

ASP.NET Core place toute la logique de démarrage de l’application dans un seul fichier, dans lequel les services et dépendances nécessaires peuvent être définis et configurés. Il remplace le fichier web.config par une fonctionnalité de configuration flexible qui peut tirer parti d’un large éventail de formats de fichiers, tels que JSON, ainsi que des variables d’environnement.