ConfigurationManager.OpenMappedMachineConfiguration Metoda

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ConfigurationManager.cs

Otwiera plik konfiguracji maszyny jako Configuration obiekt, który używa określonego mapowania plików.

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

Plik konfiguracji do użycia zamiast domyślnego pliku konfiguracji aplikacji.

Zwraca

Configuration

Plik konfiguracji maszyny.

Wyjątki

ConfigurationErrorsException

Nie można załadować pliku konfiguracji.

Przykłady

Poniższy przykład kodu pokazuje, jak za pomocą OpenMappedMachineConfiguration metody uzyskać wszystkie sekcje w pliku konfiguracji.

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

Uwagi

Ustawienia konfiguracji maszyny mają zastosowanie do całego komputera i wszystkich aplikacji znajdujących się na nim, chyba że zostaną zastąpione dla aplikacji lokalnej. Ustawienia konfiguracji maszyny są odczytywane z pliku Machine.config aktualnie uruchomionej wersji .NET Framework. Plik Machine.config znajduje się w następującym podkatalogu:

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

Uwaga

Aby uzyskać Configuration obiekt zasobu, kod musi mieć uprawnienia do odczytu na wszystkich plikach konfiguracji, z których dziedziczy ustawienia. Aby zaktualizować plik konfiguracji, kod musi mieć dodatkowo uprawnienia do zapisu zarówno dla pliku konfiguracji, jak i katalogu, w którym istnieje. Nie można uzyskać dostępu do pliku Machine.config dla innych wersji .NET Framework, które mogą być zainstalowane na komputerze.

Zobacz też

• Configuration
• ConfigurationFileMap