Partager via


Configurer des applications à l’aide de fichiers de configuration

Remarque

Cet article est spécifique à .NET Framework. Elle ne s’applique pas aux implémentations plus récentes de .NET, notamment .NET 6 et versions ultérieures.

.NET Framework offre aux développeurs et aux administrateurs un contrôle et une flexibilité sur la façon dont les applications s’exécutent via des fichiers de configuration. Les fichiers de configuration sont des fichiers XML qui peuvent être modifiés en fonction des besoins. Un administrateur peut contrôler les ressources protégées auxquelles une application peut accéder, quelles versions des assemblys qu’une application utilisera et où se trouvent les applications et objets distants. Les développeurs peuvent placer des paramètres dans des fichiers de configuration, ce qui élimine la nécessité de recompiler une application chaque fois qu’un paramètre change. Cette section décrit ce qui peut être configuré et pourquoi la configuration d’une application peut être utile.

Remarque

Le code managé peut utiliser les classes de l’espace System.Configuration de noms pour lire les paramètres des fichiers de configuration, mais pas pour écrire des paramètres dans ces fichiers.

Cet article décrit la syntaxe des fichiers de configuration et fournit des informations sur les trois types de fichiers de configuration : ordinateur, application et sécurité.

Format du fichier de configuration

Les fichiers de configuration contiennent des éléments, qui sont des structures de données logiques qui définissent des informations de configuration. Dans un fichier de configuration, vous utilisez des balises pour marquer le début et la fin d’un élément. Par exemple, l’élément <runtime> se compose <runtime>d’éléments enfants</runtime>. Un élément vide serait écrit en tant que <runtime/> ou <runtime></runtime>.

Comme avec tous les fichiers XML, la syntaxe des fichiers de configuration respecte la casse.

Vous spécifiez des paramètres de configuration à l’aide d’attributs prédéfinis, qui sont des paires nom/valeur à l’intérieur de la balise de début d’un élément. L’exemple suivant spécifie deux attributs (version et href) pour l’élément <codeBase> , qui spécifie où le runtime peut localiser un assembly (pour plus d’informations, consultez Spécification de l’emplacement d’un assembly).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Fichiers de configuration de l’ordinateur

Le fichier de configuration de l’ordinateur, Machine.config, contient les paramètres qui s’appliquent à un ordinateur entier. Ce fichier se trouve dans le chemin d’installation du runtime %%répertoire \Config. Machine.config contient les paramètres de configuration pour la liaison d’assembly à l’échelle de l’ordinateur, les canaux de communication à distance intégrés et ASP.NET.

Le système de configuration recherche d’abord dans le fichier de configuration de l’ordinateur l’élément <appSettings> et d’autres sections de configuration qu’un développeur peut définir. Il recherche ensuite dans le fichier de configuration de l’application. Pour conserver le fichier de configuration de l’ordinateur gérable, il est préférable de placer ces paramètres dans le fichier de configuration de l’application. Toutefois, le fait de placer les paramètres dans le fichier de configuration de l’ordinateur peut rendre votre système plus gérable. Par exemple, si vous avez un composant tiers que votre application cliente et serveur utilise, il est plus facile de placer les paramètres de ce composant à un seul endroit. Dans ce cas, le fichier de configuration de l’ordinateur est l’emplacement approprié pour les paramètres. Vous n’avez donc pas les mêmes paramètres dans deux fichiers différents.

Remarque

Le déploiement d’une application à l’aide de XCOPY ne copie pas les paramètres dans le fichier de configuration de l’ordinateur.

Pour plus d’informations sur la façon dont le Common Language Runtime utilise le fichier de configuration de l’ordinateur pour la liaison d’assembly, consultez Comment le runtime localise les assemblys.

Fichiers de configuration de l'application

Un fichier de configuration d’application contient des paramètres spécifiques à une application. Ce fichier comprend des paramètres de configuration que le Common Language Runtime lit (comme la stratégie de liaison d'assembly, les objets de communication à distance, etc.), et des paramètres que l'application peut lire.

Le nom et l’emplacement du fichier de configuration de l’application dépendent de l’hôte de l’application, qui peut être l’un des éléments suivants :

  • Application hébergée par l'exécutable.

    Ces applications ont deux fichiers de configuration : un fichier de configuration source, modifié par le développeur pendant le développement et un fichier de sortie distribué avec l’application.

    Par défaut, le nom du fichier de configuration source est App.config. Lorsque vous créez un projet .NET Framework dans Visual Studio, un fichier App.config est automatiquement ajouté au projet. Vous pouvez également ajouter un fichier manuellement en sélectionnant Fichier>nouveau. Placez le fichier App.config dans le répertoire du projet et définissez la propriété Copier vers le répertoire de sortie à Copier toujours ou Copier si plus récent.

    Pour créer le fichier de configuration de sortie déployé avec l’application, Visual Studio copie le fichier de configuration source dans le répertoire où l’assembly compilé est placé. Ce fichier est nommé <yourappname>.exe.config. Par exemple, une application nommée myApp.exe a un fichier de configuration de sortie nommé myApp.exe.config.

    Dans certains cas, Visual Studio peut modifier le fichier de configuration de sortie. Pour plus d’informations, consultez Redirection des versions au niveau de l’application.

  • Application hébergée ASP.NET.

    Pour plus d’informations sur ASP.NET fichiers de configuration, consultez ASP.NET Paramètres de configuration.

Fichiers de configuration de sécurité

Les fichiers de configuration de sécurité contiennent des informations sur la hiérarchie des groupes de codes et les jeux d’autorisations associés à un niveau de stratégie. Nous vous recommandons vivement d’utiliser l’outil de stratégie de sécurité d’accès au code (Caspol.exe) pour modifier la stratégie de sécurité afin de vous assurer que les modifications de stratégie n’endommagent pas les fichiers de configuration de sécurité.

Remarque

À compter de .NET Framework 4, les fichiers de configuration de sécurité sont présents uniquement si la stratégie de sécurité a été modifiée.

Les fichiers de configuration de sécurité se trouvent à l’emplacement suivant :

  • Fichier de configuration de stratégie d’entreprise : %%\Config\Enterprisesec.config runtime-install-path

  • Fichier de configuration de la stratégie de l’ordinateur : %chemin d’installation du runtime%\Config\Security.config

  • Fichier de configuration de stratégie utilisateur : %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx.xx\Security.config

Voir aussi