ConfigurationManager.OpenMappedExeConfiguration Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Membuka file konfigurasi klien yang ditentukan sebagai Configuration objek.

Overload

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)	Membuka file konfigurasi klien yang ditentukan sebagai Configuration objek yang menggunakan pemetaan file dan tingkat pengguna yang ditentukan.
OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)	Membuka file konfigurasi klien yang ditentukan sebagai Configuration objek yang menggunakan opsi pemetaan file, tingkat pengguna, dan pramuat yang ditentukan.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Sumber:

ConfigurationManager.cs

Membuka file konfigurasi klien yang ditentukan sebagai Configuration objek yang menggunakan pemetaan file dan tingkat pengguna yang ditentukan.

public:
 static System::Configuration::Configuration ^ OpenMappedExeConfiguration(System::Configuration::ExeConfigurationFileMap ^ fileMap, System::Configuration::ConfigurationUserLevel userLevel);

public static System.Configuration.Configuration OpenMappedExeConfiguration (System.Configuration.ExeConfigurationFileMap fileMap, System.Configuration.ConfigurationUserLevel userLevel);

static member OpenMappedExeConfiguration : System.Configuration.ExeConfigurationFileMap * System.Configuration.ConfigurationUserLevel -> System.Configuration.Configuration

Public Shared Function OpenMappedExeConfiguration (fileMap As ExeConfigurationFileMap, userLevel As ConfigurationUserLevel) As Configuration

Parameter

fileMap

ExeConfigurationFileMap

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

userLevel

ConfigurationUserLevel

Salah satu nilai enumerasi yang menentukan tingkat pengguna tempat Anda membuka konfigurasi.

Mengembalikan

Configuration

Objek konfigurasi.

Pengecualian

ConfigurationErrorsException

File konfigurasi tidak dapat dimuat.

Contoh

Contoh kode berikut menunjukkan cara menggunakan OpenMappedExeConfiguration metode untuk mendapatkan semua bagian yang dimuat oleh file konfigurasi.

   // Access a configuration file using mapping.
   // This function uses the OpenMappedExeConfiguration 
   // method to access a new configuration file.   
   // It also gets the custom ConsoleSection and 
   // sets its ConsoleElement BackgroundColor and
   // ForegroundColor properties to green and red
   // respectively. Then it uses these properties to
   // set the console colors.  
   public static void MapExeConfiguration()
   {

     // Get the application configuration file.
     System.Configuration.Configuration config =
       ConfigurationManager.OpenExeConfiguration(
             ConfigurationUserLevel.None);
   
     Console.WriteLine(config.FilePath);

     if (config == null)
     {
       Console.WriteLine(
         "The configuration file does not exist.");
       Console.WriteLine(
        "Use OpenExeConfiguration to create the file.");
     }

     // Create a new configuration file by saving 
     // the application configuration to a new file.
     string appName = 
       Environment.GetCommandLineArgs()[0];

     string configFile =  string.Concat(appName, 
       ".2.config");
     config.SaveAs(configFile, ConfigurationSaveMode.Full);

     // Map the new configuration file.
     ExeConfigurationFileMap configFileMap = 
         new ExeConfigurationFileMap();
     configFileMap.ExeConfigFilename = configFile;

     // Get the mapped configuration file
    config = 
       ConfigurationManager.OpenMappedExeConfiguration(
         configFileMap, ConfigurationUserLevel.None);

     // Make changes to the new configuration file. 
     // This is to show that this file is the 
     // one that is used.
     string sectionName = "consoleSection";

     ConsoleSection customSection =
       (ConsoleSection)config.GetSection(sectionName);

     if (customSection == null)
     {
         customSection = new ConsoleSection();
         config.Sections.Add(sectionName, customSection);
     }
     else
         // Change the section configuration values.
         customSection =
             (ConsoleSection)config.GetSection(sectionName);

     customSection.ConsoleElement.BackgroundColor =
         ConsoleColor.Green;
     customSection.ConsoleElement.ForegroundColor =
         ConsoleColor.Red;

     // Save the configuration file.
     config.Save(ConfigurationSaveMode.Modified);

     // Force a reload of the changed section. This 
     // makes the new values available for reading.
     ConfigurationManager.RefreshSection(sectionName);

     // Set console properties using the 
     // configuration values contained in the 
     // new configuration file.
     Console.BackgroundColor =
       customSection.ConsoleElement.BackgroundColor;
     Console.ForegroundColor =
       customSection.ConsoleElement.ForegroundColor;
     Console.Clear();

     Console.WriteLine();
     Console.WriteLine("Using OpenMappedExeConfiguration.");
     Console.WriteLine("Configuration file is: {0}", 
       config.FilePath);
   }

' Access a configuration file using mapping.
' This function uses the OpenMappedExeConfiguration 
' method to access a new configuration file.   
' It also gets the custom ConsoleSection and 
' sets its ConsoleElement BackgroundColor and
' ForegroundColor properties to green and red
' respectively. Then it uses these properties to
' set the console colors.  
Public Shared Sub MapExeConfiguration()

    ' Get the application configuration file.
    Dim config As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)

    Console.WriteLine(config.FilePath)

    If config Is Nothing Then
        Console.WriteLine( _
        "The configuration file does not exist.")
        Console.WriteLine( _
        "Use OpenExeConfiguration to create file.")
    End If

    ' Create a new configuration file by saving 
    ' the application configuration to a new file.
    Dim appName As String = _
        Environment.GetCommandLineArgs()(0)

    Dim configFile As String = _
        String.Concat(appName, "2.config")
    config.SaveAs(configFile, _
                  ConfigurationSaveMode.Full)

    ' Map the new configuration file.
    Dim configFileMap As New ExeConfigurationFileMap()
    configFileMap.ExeConfigFilename = configFile

    ' Get the mapped configuration file
    config = _
    ConfigurationManager.OpenMappedExeConfiguration( _
        configFileMap, ConfigurationUserLevel.None)

    ' Make changes to the new configuration file. 
    ' This is to show that this file is the 
    ' one that is used.
    Dim sectionName As String = "consoleSection"

    Dim customSection As ConsoleSection = _
        DirectCast(config.GetSection(sectionName),  _
            ConsoleSection)

    If customSection Is Nothing Then
        customSection = New ConsoleSection()
        config.Sections.Add(sectionName, customSection)
    End If

    ' Change the section configuration values.
    customSection = _
        DirectCast(config.GetSection(sectionName),  _
            ConsoleSection)
    customSection.ConsoleElement.BackgroundColor = _
        ConsoleColor.Green
    customSection.ConsoleElement.ForegroundColor = _
        ConsoleColor.Red
    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)

    ' Force a reload of the changed section. This 
    ' makes the new values available for reading.
    ConfigurationManager.RefreshSection(sectionName)

    ' Set console properties using the 
    ' configuration values contained in the 
    ' new configuration file.
    Console.BackgroundColor = _
        customSection.ConsoleElement.BackgroundColor
    Console.ForegroundColor = _
        customSection.ConsoleElement.ForegroundColor
    Console.Clear()

    Console.WriteLine()
    Console.WriteLine( _
        "Using OpenMappedExeConfiguration.")
    Console.WriteLine( _
        "Configuration file is: {0}", config.FilePath)
End Sub

Keterangan

Objek ConfigurationUserLevel menentukan lokasi file konfigurasi yang sedang dibuka. Ini menunjukkan apakah file tidak memiliki tingkat pengguna (file konfigurasi berada dalam direktori yang sama dengan aplikasi) atau memiliki tingkat per pengguna (file konfigurasi berada di jalur pengaturan aplikasi yang ditentukan oleh userLevel).

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.

Lihat juga

• ConfigurationUserLevel
• Configuration

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Sumber:

ConfigurationManager.cs

Membuka file konfigurasi klien yang ditentukan sebagai Configuration objek yang menggunakan opsi pemetaan file, tingkat pengguna, dan pramuat yang ditentukan.

public:
 static System::Configuration::Configuration ^ OpenMappedExeConfiguration(System::Configuration::ExeConfigurationFileMap ^ fileMap, System::Configuration::ConfigurationUserLevel userLevel, bool preLoad);

public static System.Configuration.Configuration OpenMappedExeConfiguration (System.Configuration.ExeConfigurationFileMap fileMap, System.Configuration.ConfigurationUserLevel userLevel, bool preLoad);

static member OpenMappedExeConfiguration : System.Configuration.ExeConfigurationFileMap * System.Configuration.ConfigurationUserLevel * bool -> System.Configuration.Configuration

Public Shared Function OpenMappedExeConfiguration (fileMap As ExeConfigurationFileMap, userLevel As ConfigurationUserLevel, preLoad As Boolean) As Configuration

Parameter

fileMap

ExeConfigurationFileMap

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

userLevel

ConfigurationUserLevel

Salah satu nilai enumerasi yang menentukan tingkat pengguna tempat Anda membuka konfigurasi.

preLoad

Boolean

true untuk memuat semua grup dan bagian bagian; jika tidak, false.

Mengembalikan

Configuration

Objek konfigurasi.

Pengecualian

ConfigurationErrorsException

File konfigurasi tidak dapat dimuat.

Keterangan

Objek ConfigurationUserLevel menentukan lokasi file konfigurasi yang sedang dibuka. Ini menunjukkan apakah file tidak memiliki tingkat pengguna (file konfigurasi berada dalam direktori yang sama dengan aplikasi) atau memiliki tingkat per pengguna (file konfigurasi berada di jalur pengaturan aplikasi yang ditentukan oleh userLevel).

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.

Untuk contoh kode, lihat OpenMappedExeConfiguration kelebihan beban.