ConfigurationManager.OpenMachineConfiguration 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 na bieżącym komputerze jako Configuration obiekt.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration();

public static System.Configuration.Configuration OpenMachineConfiguration ();

static member OpenMachineConfiguration : unit -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration () As Configuration

Zwraca

Configuration

Plik konfiguracji maszyny.

Wyjątki

ConfigurationErrorsException

Nie można załadować pliku konfiguracji.

Przykłady

Poniższy przykład kodu przedstawia sposób użycia OpenMachineConfiguration metody w celu uzyskania wszystkich sekcji zawartych 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 komputera 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 dla zasobu, kod musi mieć uprawnienia do odczytu dla wszystkich plików konfiguracji, z których dziedziczy ustawienia. Aby zaktualizować plik konfiguracji, kod musi dodatkowo mieć 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