Fichiers de configuration

Les fichiers de configuration sont des fichiers XML qui peuvent être modifiés selon les besoins. Les développeurs peuvent utiliser les fichiers de configuration pour modifier des paramètres sans recompiler leurs applications. Les administrateurs peuvent utiliser les fichiers de configuration pour définir des stratégies qui affectent la façon dont les applications s'exécutent sur leurs ordinateurs.

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

Cette rubrique 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 des fichiers 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 indiquer le début et la fin d'un élément. Par exemple, l'élément <runtime> est constitué de <runtime>éléments enfants </runtime>. Un élément vide possède une balise de début, mais pas de balise de fin.

Vous spécifiez des paramètres de configuration à l'aide d'attributs prédéfinis qui sont des paires nom/valeur contenus dans la balise de début d'un élément. L'exemple suivant spécifie deux attributs (version et href pour l'élément <codeBase>, ce qui spécifie l'emplacement 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"/>

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

Fichiers de configuration machine

Le fichier de configuration machine, Machine.config, contient des paramètres qui s'appliquent à l'ordinateur tout entier. Ce fichier est situé dans le répertoire %chemin d'installation du runtime%\Config. Machine.config contient des paramètres de configuration d'une liaison d'assemblys accessible sur la totalité de l'ordinateur, de canaux de communication à distance intégrés et d'ASP.NET.

Le système de configuration recherche d'abord l'élément appSettings) et les autres sections de configuration éventuellement définies par un développeur dans le fichier de configuration machine. Ensuite, il cherche ensuite dans le fichier de configuration de l'application. Pour que le fichier de configuration machine reste gérable, il est préférable de placer ces paramètres dans le fichier de configuration de l'application. Cependant, le fait de placer les paramètres dans le fichier de configuration machine peut rendre votre système plus facile à entretenir. Par exemple, si vous possédez un composant de tiers utilisé à la fois par votre application cliente et serveur, il est plus aisé de placer les paramètres pour ce composant dans un seul emplacement. Dans ce cas, le fichier de configuration machine est l'emplacement le plus approprié pour les paramètres, de manière à éviter d'avoir les mêmes paramètres dans deux fichiers différents.

Remarque
Le déploiement d'une application utilisant XCOPY ne copiera pas les paramètres dans le fichier de configuration machine.

Pour plus d'informations sur la façon dont le Common Language Runtime utilise le fichier de configuration machine pour les liaisons d'assemblys, consultez Méthode de localisation des assemblys par le runtime.

Fichiers de configuration des applications

Les fichiers de configuration des applications contiennent des paramètres spécifiques à une application. Ce fichier contient des paramètres de configuration que le Common Language Runtime lit (tels qu'une stratégie de liaison d'assembly, des 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 hôtes suivants :

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

  Le fichier de configuration d'une application hébergée par l'hôte exécutable se situe dans le même répertoire que l'application. Le nom du fichier de configuration est le nom de l'application assorti d'une extension .config. Par exemple, une application appelée myApp.exe peut être associée à un fichier de configuration appelé myApp.exe.config.

  Remarque
  Dans les projets Visual Studio, placez le fichier .config dans le répertoire de projet et affectez la valeur Toujours copier ou Copier si plus récent à la propriété Copier dans le répertoire de sortie.Visual Studio copie automatiquement le fichier dans le répertoire de compilation de l'assembly.

• Application hébergée par ASP.NET.

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

• Application hébergée par Internet Explorer.

  Si une application hébergée dans Internet Explorer possède un fichier de configuration, l'emplacement de ce fichier est spécifié dans une balise <link> dont la syntaxe est la suivante :

  <link rel="NomFichierConfiguration" href="emplacement">

  Dans cette balise, location représente une URL vers le fichier de configuration. Ceci définit la base d'applications. Le fichier de configuration doit être situé sur le même site Web que l'application.

Fichiers de configuration de sécurité

Les fichiers de configuration de sécurité contiennent des informations sur la hiérarchie du groupe de codes et des jeux d'autorisations associée à un niveau de stratégie. Nous vous recommandons fortement d'utiliser l'outil .NET Framework Configuration Tool (Mscorcfg.msc) ou l'outil Stratégie de sécurité d'accès du code (Caspol.exe) pour modifier la stratégie de sécurité et éviter que les changements de stratégie ne corrompent les fichiers de configuration de sécurité.

Remarque
En commençant par le .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 dans les emplacements suivants :

• Fichier de configuration de la stratégie d'entreprise : %chemin-d'installation-du-runtime%\Config\Enterprisesec.config

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

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

Voir aussi

Référence

Mscorcfg.msc (outil .NET Framework Configuration)

Caspol.exe (outil Stratégie de sécurité d'accès du code)

Concepts

Spécification de l'emplacement d'un assembly

Redirection des versions d'assemblys

Assemblys dans le Common Language Runtime

Autres ressources

Schéma des fichiers de configuration pour le .NET Framework

Paramètres de configuration ASP.NET

Gestion de la stratégie de sécurité

Remote Objects

Historique des modifications

Date	Historique	Motif
Mars 2011	Les informations sur les fichiers de configuration de sécurité ont été mises à jour.	Résolution des bogues de contenu.