ConfigurationManager.OpenMappedMachineConfiguration Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

ConfigurationManager.cs

Membuka file konfigurasi komputer sebagai Configuration objek yang menggunakan pemetaan file yang ditentukan.

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

Parameter

fileMap

ConfigurationFileMap

File konfigurasi yang akan digunakan alih-alih file konfigurasi default aplikasi.

Mengembalikan

Configuration

File konfigurasi komputer.

Pengecualian

ConfigurationErrorsException

File konfigurasi tidak dapat dimuat.

Contoh

Contoh kode berikut menunjukkan cara menggunakan OpenMappedMachineConfiguration metode untuk mendapatkan semua bagian dalam file konfigurasi.

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

Keterangan

Pengaturan konfigurasi komputer berlaku untuk seluruh komputer dan semua aplikasi yang berada di dalamnya, kecuali ditimpa untuk aplikasi lokal. Pengaturan konfigurasi komputer dibaca dari file Machine.config dari versi .NET Framework yang sedang berjalan. File Machine.config terletak di subdirektori berikut:

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

Catatan

Untuk mendapatkan Configuration objek untuk sumber daya, kode Anda harus memiliki izin baca pada semua file konfigurasi tempat objek mewarisi pengaturan. Untuk memperbarui file konfigurasi, kode Anda juga harus memiliki izin tulis untuk file konfigurasi dan direktori tempat file tersebut ada. Tidak dimungkinkan untuk mengakses file Machine.config untuk versi .NET Framework lain yang mungkin diinstal pada komputer.

Lihat juga

• Configuration
• ConfigurationFileMap