ConfigurationManager.OpenMappedMachineConfiguration Metodo

Definizione

Apre il file di configurazione del computer come un oggetto Configuration che usa il mapping del file specificato.

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

Parametri

fileMap
ConfigurationFileMap

File di configurazione da usare anziché il file di configurazione predefinito dell'applicazione.

Restituisce

File di configurazione del computer.

Eccezioni

Non è stato possibile caricare un file di configurazione.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il OpenMappedMachineConfiguration metodo per ottenere tutte le sezioni nel file di configurazione.

C#
   // 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);
     }
   }

Commenti

Le impostazioni di configurazione del computer si applicano all'intero computer e a tutte le applicazioni che si trovano in esso, a meno che non venga sottoposto a override per l'applicazione locale. Le impostazioni di configurazione del computer vengono lette dal file Machine.config della versione attualmente in esecuzione di .NET Framework. Il file Machine.config si trova nella sottodirectory seguente:

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

Nota

Per ottenere l'oggetto Configuration per una risorsa, il codice deve disporre delle autorizzazioni di lettura per tutti i file di configurazione da cui eredita le impostazioni. Per aggiornare un file di configurazione, il codice deve inoltre disporre delle autorizzazioni di scrittura sia per il file di configurazione che per la directory in cui esiste. Non è possibile accedere al file Machine.config per altre versioni di .NET Framework che potrebbero essere installate nel computer.

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Vedi anche