ConfigurationManager.OpenMappedMachineConfiguration Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationManager.cs

Ouvre le fichier de configuration machine en tant qu’objet Configuration utilisant le mappage de fichiers spécifié.

public:
 static System::Configuration::Configuration ^ OpenMappedMachineConfiguration(System::Configuration::ConfigurationFileMap ^ fileMap);

public static System.Configuration.Configuration OpenMappedMachineConfiguration (System.Configuration.ConfigurationFileMap fileMap);

static member OpenMappedMachineConfiguration : System.Configuration.ConfigurationFileMap -> System.Configuration.Configuration

Public Shared Function OpenMappedMachineConfiguration (fileMap As ConfigurationFileMap) As Configuration

Paramètres

fileMap

ConfigurationFileMap

Fichier de configuration à utiliser à la place du fichier de configuration par défaut de l’application.

Retours

Configuration

Fichier de configuration de l’ordinateur.

Exceptions

ConfigurationErrorsException

Nous n’avons pas pu charger un fichier de configuration.

Exemples

L’exemple de code suivant montre comment utiliser la OpenMappedMachineConfiguration méthode pour obtenir toutes les sections du fichier de configuration.

   // Access the machine configuration file using mapping.
   // The function uses the OpenMappedMachineConfiguration 
   // method to access the machine configuration. 
   public static void MapMachineConfiguration()
   {
     // Get the machine.config file.
     Configuration machineConfig =
       ConfigurationManager.OpenMachineConfiguration();
     // Get the machine.config file path.
     ConfigurationFileMap configFile =
       new ConfigurationFileMap(machineConfig.FilePath);

     // Map the application configuration file to the machine 
     // configuration file.
     Configuration config =
       ConfigurationManager.OpenMappedMachineConfiguration(
         configFile);

     // Get the AppSettings section.
     AppSettingsSection appSettingSection =
       (AppSettingsSection)config.GetSection("appSettings");
     appSettingSection.SectionInformation.AllowExeDefinition =
         ConfigurationAllowExeDefinition.MachineToRoamingUser;

     // Display the configuration file sections.
     ConfigurationSectionCollection sections = 
       config.Sections;

     Console.WriteLine();
     Console.WriteLine("Using OpenMappedMachineConfiguration.");
     Console.WriteLine("Sections in machine.config:");

     // Get the sections in the machine.config.
     foreach (ConfigurationSection section in sections)
     {
         string name = section.SectionInformation.Name;
         Console.WriteLine("Name: {0}", name);
     }
   }

' Access the machine configuration file using mapping.
' The function uses the OpenMappedMachineConfiguration 
' method to access the machine configuration. 
Public Shared Sub MapMachineConfiguration()
    ' Get the machine.config file.
    Dim machineConfig As Configuration = _
        ConfigurationManager.OpenMachineConfiguration()
    ' Get the machine.config file path.
    Dim configFile _
        As New ConfigurationFileMap( _
            machineConfig.FilePath)

    ' Map the application configuration file 
    ' to the machine configuration file.
    Dim config As Configuration = _
        ConfigurationManager. _
        OpenMappedMachineConfiguration( _
            configFile)

    ' Get the AppSettings section.
    Dim appSettingSection As AppSettingsSection = _
        DirectCast(config.GetSection("appSettings"),  _
            AppSettingsSection)
    appSettingSection.SectionInformation. _
    AllowExeDefinition = _
        ConfigurationAllowExeDefinition. _
        MachineToRoamingUser

    ' Display the configuration file sections.
    Dim sections As  _
        ConfigurationSectionCollection = _
        config.Sections

    Console.WriteLine()
    Console.WriteLine( _
        "Using OpenMappedMachineConfiguration.")
    Console.WriteLine( _
        "Sections in machine.config:")

    ' Get the sections in the machine.config.
    For Each section _
        As ConfigurationSection In sections
        Dim name As String = _
            section.SectionInformation.Name
        Console.WriteLine("Name: {0}", name)
    Next

End Sub

Remarques

Les paramètres de configuration de l’ordinateur s’appliquent à l’ensemble de l’ordinateur et à toutes les applications qui résident sur celui-ci, sauf s’ils sont remplacés pour l’application locale. Les paramètres de configuration de l’ordinateur sont lus à partir du fichier Machine.config de la version en cours d’exécution de .NET Framework. Le fichier Machine.config se trouve dans le sous-répertoire suivant :

%windir%\Microsoft.NET\Framework\version\config

Notes

Pour obtenir l’objet Configuration d’une ressource, votre code doit disposer d’autorisations de lecture sur tous les fichiers de configuration dont il hérite des paramètres. Pour mettre à jour un fichier de configuration, votre code doit en outre disposer d’autorisations d’écriture pour le fichier de configuration et le répertoire dans lequel il existe. Il n’est pas possible d’accéder au fichier Machine.config pour d’autres versions du .NET Framework qui peuvent être installées sur l’ordinateur.

Voir aussi

• Configuration
• ConfigurationFileMap