La classe ConfigurationManager vous permet d'accéder aux informations de configuration machine, de l'application et utilisateur. Cette classe remplace la classe ConfigurationSettings, qui est désapprouvée.

Les applications clientes s'exécutent sur l'ordinateur client, tandis que les applications Web s'exécutent sur l'ordinateur serveur auquel le client est connecté.

Vous pouvez utiliser les types System.Configuration intégrés ou en dériver afin de gérer les informations de configuration. L'utilisation de ces types vous permet de travailler directement avec les informations de configuration et vous pouvez étendre les fichiers de configuration de façon à inclure des informations personnalisées.

La classe ConfigurationManager contient des membres qui vous permettent d'effectuer les tâches suivantes.

• Lecture d'une section d'un fichier de configuration. Pour accéder aux informations de configuration, appelez la méthode GetSection. Pour quelques sections telles que appSettings et connectionStrings, utilisez les classes AppSettings et ConnectionStrings. Ces membres exécutent des opérations en lecture seule, utilisent une instance unique mise en cache de la configuration et sont sensibles au multithread.

• Lecture et écriture globale de fichiers de configuration. Votre application peut lire et écrire des paramètres de configuration à tout niveau, pour elle-même ou pour d'autres applications ou ordinateurs, localement ou à distance. Utilisez l'une des méthodes fournies par la classe ConfigurationManager pour ouvrir un fichier de configuration, tel que SampleApp.exe.config. Ces méthodes retournent un objet Configuration qui, à son tour, expose des méthodes et des propriétés que vous pouvez utiliser pour travailler avec les fichiers de configuration associés. Les méthodes exécutent des opérations de lecture ou d'écriture et recréent les données de configuration chaque fois qu'un fichier est écrit.

• Prise en charge des tâches de configuration. Les types suivants sont utilisés pour prendre en charge diverses tâches de configuration :

  • SectionInformation

  • PropertyInformation

  • PropertyInformationCollection

  • ElementInformation

  • ContextInformation

  • ConfigurationSectionGroup

  • ConfigurationSectionGroupCollection

  En plus de travailler avec les informations de configuration existantes, vous pouvez créer et travailler avec des éléments de configuration personnalisés en étendant les types de configuration intégrés, tels que les classes ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty et ConfigurationSection. Pour obtenir un exemple sur la façon d'étendre un type de configuration intégré par programme, consultez ConfigurationSection. Pour obtenir un exemple de la façon d'étendre un type de configuration intégré à l'aide du modèle basé sur les attributs, consultez ConfigurationElement.

Remarques à l'attention des implémenteurs La classe Configuration autorise l'accès par programme pour modifier les fichiers de configuration. Vous utilisez l'une des méthodes Open fournies par ConfigurationManager. Ces méthodes retournent un objet Configuration qui, à son tour, fournit les méthodes et propriétés requises pour gérer les fichiers de configuration sous-jacents. Vous pouvez accéder à ces fichiers en lecture ou en écriture. Pour lire les fichiers de configuration, utilisez GetSection ou GetSectionGroup afin de lire les informations de configuration. L'utilisateur ou le processus qui lit doit avoir les autorisations suivantes :

• Autorisation en lecture sur le fichier de configuration au niveau de la hiérarchie de configuration en cours.

• Autorisations en lecture sur tous les fichiers de configuration parents.

• Autorisation en écriture sur le fichier de configuration et le répertoire au niveau de la hiérarchie de configuration en cours.

• Autorisations en lecture sur tous les fichiers de configuration.

L'exemple de code suivant montre comment utiliser la classe ConfigurationManager pour accéder à une section de configuration personnalisée. Si la section n'existe pas, elle est créée et ajoutée au fichier de configuration. La classe de section personnalisée utilisée dans cet exemple est implémentée dans l'exemple contenu dans la classe ConfigurationPropertyAttribute.

 ' Create a custom section.
Shared Sub New()
   ' Get the application configuration file.
     Dim config As System.Configuration.Configuration = _
     ConfigurationManager.OpenExeConfiguration( _
     ConfigurationUserLevel.None)
   ' Console.WriteLine(config.FilePath);
   ' If the section does not exiat in the configuration
   ' file, create it and save it to the file.
   If config.Sections(customSectionName) Is Nothing Then
      custSection = New CustomSection()
      config.Sections.Add(customSectionName, custSection)
      custSection = config.GetSection(customSectionName)
      custSection.SectionInformation.ForceSave = True
      config.Save(ConfigurationSaveMode.Full)
   End If
End Sub 'New

// Create a custom section.
static UsingConfigurationManager()
{
    // Get the application configuration file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);
 
    // If the section does not exist in the configuration
    // file, create it and save it to the file.
    if (config.Sections[customSectionName] == null)
    {
        custSection = new CustomSection();
        config.Sections.Add(customSectionName, custSection);
        custSection =
            config.GetSection(customSectionName) as CustomSection;
        custSection.SectionInformation.ForceSave = true;
        config.Save(ConfigurationSaveMode.Full);
    }
}

L'exemple fonctionne avec les éléments illustrés dans le fichier de configuration suivant, lequel est généré la première fois que vous exécutez l'exemple.

Remarque
Vous devez définir l'attribut Version de façon à refléter vos exigences de contrôle de version.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="CustomSection" 
       type="Samples.Config.CustomSection,
         ConfigurationManager, 
         Version=1.0.0.0, 
         Culture=neutralPublicKeyToken=null" 
         allowDefinition="Everywhere" 
         allowExeDefinition="MachineToApplication" 
         restartOnExternalChanges="true" />
  </configSections>
  <connectionStrings>
    <add name="ConnStr1" 
      connectionString="LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;Initial Catalog=aspnetdb"
      providerName="System.Data.SqlClient" />
    <add name="ConnStr2" 
      connectionString="LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;Initial Catalog=aspnetdb"
      providerName="System.Data.SqlClient" />
  </connectionStrings>
  <appSettings>
    <add key="AppSetting0" 
      value="Monday, February 28, 2005 1:27:59 PM" />
    <add key="AppSetting1" 
      value="Monday, February 28, 2005 1:36:40 PM" />
  </appSettings>
  <CustomSection fileName="default.txt" maxUsers="1000" 
     maxIdleTime="00:10:00" />
</configuration>

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework