ConfigurationManager.OpenMappedMachineConfiguration Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v11.0.0-preview.5.26302.115

Zdroj:

ConfigurationManager.cs

Otevře konfigurační soubor počítače jako objekt Configuration, který používá zadané mapování souborů.

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

Parametry

fileMap

ConfigurationFileMap

Konfigurační soubor, který se má použít místo výchozího konfiguračního souboru aplikace.

Návraty

Configuration

Konfigurační soubor počítače.

Výjimky

ConfigurationErrorsException

Konfigurační soubor nelze načíst.

Příklady

Následující příklad kódu ukazuje, jak použít metodu OpenMappedMachineConfiguration k získání všech oddílů v konfiguračním souboru.

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

Poznámky

Nastavení konfigurace počítače platí pro celý počítač a všechny aplikace, které se na něm nacházejí, pokud nejsou přepsány pro místní aplikaci. Nastavení konfigurace počítače se načítá ze souboru Machine.config aktuálně spuštěné verze .NET Frameworku. Soubor Machine.config se nachází v následujícím podadresáři:

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

Note

Chcete-li získat Configuration objekt prostředku, musí mít váš kód oprávnění ke čtení pro všechny konfigurační soubory, ze kterých dědí nastavení. Pokud chcete aktualizovat konfigurační soubor, musí mít váš kód navíc oprávnění k zápisu pro konfigurační soubor i adresář, ve kterém existuje. Není možné získat přístup k souboru Machine.config pro jiné verze .NET Framework, které mohou být nainstalovány v počítači.

Viz také

• Configuration
• ConfigurationFileMap