ConfigurationManager.OpenMappedMachineConfiguration Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationManager.cs

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

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

Parametri

fileMap

ConfigurationFileMap

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

Restituisce

Configuration

File di configurazione del computer.

Eccezioni

ConfigurationErrorsException

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.

   // 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

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.

Vedi anche

• Configuration
• ConfigurationFileMap