ConfigurationManager.OpenMappedExeConfiguration Yöntem

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Belirtilen istemci yapılandırma dosyasını nesne Configuration olarak açar.

Aşırı Yüklemeler

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)	Belirtilen istemci yapılandırma dosyasını, belirtilen dosya eşlemesini ve kullanıcı düzeyini kullanan bir Configuration nesne olarak açar.
OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)	Belirtilen istemci yapılandırma dosyasını, belirtilen dosya eşleme, kullanıcı düzeyi ve ön yükleme seçeneğini kullanan bir Configuration nesne olarak açar.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Kaynak:

ConfigurationManager.cs

Belirtilen istemci yapılandırma dosyasını, belirtilen dosya eşlemesini ve kullanıcı düzeyini kullanan bir Configuration nesne olarak açar.

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

Parametreler

fileMap

ExeConfigurationFileMap

Uygulama varsayılan yapılandırma dosyası yerine kullanılacak yapılandırma dosyası.

userLevel

ConfigurationUserLevel

Yapılandırmayı açmakta olduğunuz kullanıcı düzeyini belirten numaralandırma değerlerinden biri.

Döndürülenler

Configuration

Yapılandırma nesnesi.

Özel durumlar

ConfigurationErrorsException

Yapılandırma dosyası yüklenemedi.

Örnekler

Aşağıdaki kod örneği, yapılandırma dosyasının OpenMappedExeConfiguration içerdiği tüm bölümleri almak için yönteminin nasıl kullanılacağını gösterir.

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

Açıklamalar

ConfigurationUserLevel nesnesi, açılan yapılandırma dosyasının konumunu belirler. Dosyanın kullanıcı düzeyi (yapılandırma dosyası uygulamayla aynı dizinde) veya kullanıcı başına düzeyi olup olmadığını gösterir (yapılandırma dosyası tarafından userLevelbelirlenen bir uygulama ayarları yolundadır).

Not

Bir kaynağın Configuration nesnesini almak için kodunuzun ayarları devraldığı tüm yapılandırma dosyaları üzerinde okuma izinlerine sahip olması gerekir. Bir yapılandırma dosyasını güncelleştirmek için kodunuzun hem yapılandırma dosyası hem de bulunduğu dizin için yazma izinlerine sahip olması gerekir.

Ayrıca bkz.

• ConfigurationUserLevel
• Configuration

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Kaynak:

ConfigurationManager.cs

Belirtilen istemci yapılandırma dosyasını, belirtilen dosya eşleme, kullanıcı düzeyi ve ön yükleme seçeneğini kullanan bir Configuration nesne olarak açar.

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

Parametreler

fileMap

ExeConfigurationFileMap

Varsayılan uygulama yapılandırma dosyası yerine kullanılacak yapılandırma dosyası.

userLevel

ConfigurationUserLevel

Yapılandırmayı açmakta olduğunuz kullanıcı düzeyini belirten numaralandırma değerlerinden biri.

preLoad

Boolean

true tüm bölüm gruplarını ve bölümlerini önceden yüklemek için; aksi takdirde , false.

Döndürülenler

Configuration

Yapılandırma nesnesi.

Özel durumlar

ConfigurationErrorsException

Yapılandırma dosyası yüklenemedi.

Açıklamalar

ConfigurationUserLevel nesnesi, açılan yapılandırma dosyasının konumunu belirler. Dosyanın kullanıcı düzeyi (yapılandırma dosyası uygulamayla aynı dizinde) veya kullanıcı başına düzeyi olup olmadığını gösterir (yapılandırma dosyası tarafından userLevelbelirlenen bir uygulama ayarları yolundadır).

Not

Bir kaynağın Configuration nesnesini almak için kodunuzun ayarları devraldığı tüm yapılandırma dosyaları üzerinde okuma izinlerine sahip olması gerekir. Bir yapılandırma dosyasını güncelleştirmek için kodunuzun hem yapılandırma dosyası hem de bulunduğu dizin için yazma izinlerine sahip olması gerekir.

Kod örneği için bkz OpenMappedExeConfiguration . aşırı yükleme.