ConfigurationManager.OpenMappedExeConfiguration Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Otevře zadaný konfigurační soubor klienta jako Configuration objekt.

Přetížení

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)	Otevře zadaný konfigurační soubor klienta jako Configuration objekt, který používá zadané mapování souborů a úroveň uživatele.
OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)	Otevře zadaný konfigurační soubor klienta jako Configuration objekt, který používá zadané mapování souborů, úroveň uživatele a možnost předběžného načtení.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Zdroj:

ConfigurationManager.cs

Otevře zadaný konfigurační soubor klienta jako Configuration objekt, který používá zadané mapování souborů a úroveň uživatele.

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

Parametry

fileMap

ExeConfigurationFileMap

Konfigurační soubor, který se má použít místo výchozího konfiguračního souboru aplikace.

userLevel

ConfigurationUserLevel

Jedna z hodnot výčtu, která určuje úroveň uživatele, pro kterou otevíráte konfiguraci.

Návraty

Configuration

Objekt konfigurace.

Výjimky

ConfigurationErrorsException

Konfigurační soubor nelze načíst.

Příklady

Následující příklad kódu ukazuje, jak pomocí OpenMappedExeConfiguration metody získat všechny oddíly, které jsou obsaženy v konfiguračním souboru.

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

Poznámky

Objekt ConfigurationUserLevel určuje umístění konfiguračního souboru, který se otevírá. Označuje, jestli soubor nemá žádnou úroveň uživatele (konfigurační soubor je ve stejném adresáři jako aplikace), nebo jestli má úroveň pro jednotlivé uživatele (konfigurační soubor je v cestě nastavení aplikace určené pomocí userLevel).

Poznámka

Chcete-li získat Configuration objekt pro prostředek, váš kód musí mít oprávnění ke čtení všech konfiguračních souborů, ze kterých dědí nastavení. Chcete-li aktualizovat konfigurační soubor, musí mít kód navíc oprávnění k zápisu pro konfigurační soubor i adresář, ve kterém existuje.

Viz také

• ConfigurationUserLevel
• Configuration

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Zdroj:

ConfigurationManager.cs

Otevře zadaný konfigurační soubor klienta jako Configuration objekt, který používá zadané mapování souborů, úroveň uživatele a možnost předběžného načtení.

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

Parametry

fileMap

ExeConfigurationFileMap

Konfigurační soubor, který se má použít místo výchozího konfiguračního souboru aplikace.

userLevel

ConfigurationUserLevel

Jedna z hodnot výčtu, která určuje úroveň uživatele, pro kterou otevíráte konfiguraci.

preLoad

Boolean

truepředem načíst všechny skupiny oddílů a oddíly; v opačném případě . false

Návraty

Configuration

Objekt konfigurace.

Výjimky

ConfigurationErrorsException

Konfigurační soubor nelze načíst.

Poznámky

Objekt ConfigurationUserLevel určuje umístění konfiguračního souboru, který se otevírá. Označuje, jestli soubor nemá žádnou úroveň uživatele (konfigurační soubor je ve stejném adresáři jako aplikace), nebo jestli má úroveň pro jednotlivé uživatele (konfigurační soubor je v cestě nastavení aplikace, která je určená ).userLevel

Poznámka

Chcete-li získat Configuration objekt pro prostředek, váš kód musí mít oprávnění ke čtení všech konfiguračních souborů, ze kterých dědí nastavení. Chcete-li aktualizovat konfigurační soubor, musí mít kód navíc oprávnění k zápisu pro konfigurační soubor i adresář, ve kterém existuje.

Příklad kódu najdete v OpenMappedExeConfiguration tématu přetížení.