ConfigurationManager.OpenMappedExeConfiguration ConfigurationManager.OpenMappedExeConfiguration ConfigurationManager.OpenMappedExeConfiguration ConfigurationManager.OpenMappedExeConfiguration Method

Definition

Öffnet die angegebene Clientkonfigurationsdatei als Configuration-Objekt.Opens the specified client configuration file as a Configuration object.

Überlädt

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Öffnet die angegebene Clientkonfigurationsdatei als Configuration-Objekt mithilfe der angegebenen Dateizuordnung und Benutzerebene.Opens the specified client configuration file as a Configuration object that uses the specified file mapping and user level.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Öffnet die angegebene Clientkonfigurationsdatei als Configuration-Objekt mithilfe der angegebenen Dateizuordnung, Benutzerebene und Vorladeoption.Opens the specified client configuration file as a Configuration object that uses the specified file mapping, user level, and preload option.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Öffnet die angegebene Clientkonfigurationsdatei als Configuration-Objekt mithilfe der angegebenen Dateizuordnung und Benutzerebene.Opens the specified client configuration file as a Configuration object that uses the specified file mapping and user level.

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

Ein ExeConfigurationFileMap-Objekt, das auf die Konfigurationsdatei verweist, die statt der Standard-Anwendungskonfigurationsdatei verwendet werden sollte.An ExeConfigurationFileMap object that references configuration file to use instead of the application default configuration file.

userLevel
ConfigurationUserLevel ConfigurationUserLevel ConfigurationUserLevel ConfigurationUserLevel

Das ConfigurationUserLevel-Objekt, für das Sie die Konfiguration öffnen.The ConfigurationUserLevel object for which you are opening the configuration.

Gibt zurück

Konfigurationsobjekt.The configuration object.

Ausnahmen

Eine Konfigurationsdatei konnte nicht geladen werden.A configuration file could not be loaded.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der OpenMappedExeConfiguration Methode, um alle Abschnitte zu erhalten, die von der Konfigurationsdatei enthalten sind.The following code example shows how to use the OpenMappedExeConfiguration method to obtain all sections that are contained by the configuration file.


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

Hinweise

Die ConfigurationUserLevel -Objekt bestimmt den Speicherort der Konfigurationsdatei, die geöffnet wird.The ConfigurationUserLevel object determines the location of the configuration file being opened. Gibt an, ob die Datei keine Benutzerebene (die Konfigurationsdatei befindet sich im gleichen Verzeichnis wie die Anwendung) oder eine benutzerdefinierte Ebene (die Konfigurationsdatei befindet sich in den Pfad einer Anwendung-Einstellungen bestimmt, indem userLevel).It indicates whether the file has no user level (the configuration file is in the same directory as the application) or has a per-user level (the configuration file is in an application settings path determined by userLevel).

Hinweis

Zum Abrufen der Configuration Objekt für eine Ressource, Ihr Code muss über Leseberechtigungen für alle Konfigurationsdateien, die von der sie die Einstellungen erbt.To obtain the Configuration object for a resource, your code must have read permissions on all the configuration files from which it inherits settings. Um eine Konfigurationsdatei zu aktualisieren, muss Ihr Code außerdem Schreibberechtigungen für die Konfigurationsdatei und das Verzeichnis, in dem sie vorhanden ist.To update a configuration file, your code must additionally have write permissions for both the configuration file and the directory in which it exists.

Siehe auch

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean) OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Öffnet die angegebene Clientkonfigurationsdatei als Configuration-Objekt mithilfe der angegebenen Dateizuordnung, Benutzerebene und Vorladeoption.Opens the specified client configuration file as a Configuration object that uses the specified file mapping, user level, and preload option.

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

Ein ExeConfigurationFileMap-Objekt, das auf die Konfigurationsdatei verweist, die statt der Standard-Anwendungskonfigurationsdatei verwendet werden sollte.An ExeConfigurationFileMap object that references the configuration file to use instead of the default application configuration file.

userLevel
ConfigurationUserLevel ConfigurationUserLevel ConfigurationUserLevel ConfigurationUserLevel

Das ConfigurationUserLevel-Objekt, für das Sie die Konfiguration öffnen.The ConfigurationUserLevel object for which you are opening the configuration.

preLoad
Boolean Boolean Boolean Boolean

true, um alle Abschnittsgruppen und Abschnitte vorab zu laden; andernfalls false.true to preload all section groups and sections; otherwise, false.

Gibt zurück

Konfigurationsobjekt.The configuration object.

Ausnahmen

Eine Konfigurationsdatei konnte nicht geladen werden.A configuration file could not be loaded.

Hinweise

Die ConfigurationUserLevel -Objekt bestimmt den Speicherort der Konfigurationsdatei, das geöffnet wird.The ConfigurationUserLevel object determines the location of the configuration file that is being opened. Gibt an, ob die Datei keine Benutzerebene (die Konfigurationsdatei befindet sich im gleichen Verzeichnis wie die Anwendung) oder eine benutzerdefinierte Ebene (die Konfigurationsdatei befindet sich in den Pfad einer Anwendung-Einstellungen, die vom bestimmt userLevel).It indicates whether the file has no user level (the configuration file is in the same directory as the application) or has a per-user level (the configuration file is in an application settings path that is determined by userLevel).

Hinweis

Zum Abrufen der Configuration Objekt für eine Ressource, Ihr Code muss über Leseberechtigungen für alle Konfigurationsdateien, die von der sie die Einstellungen erbt.To obtain the Configuration object for a resource, your code must have read permissions on all the configuration files from which it inherits settings. Um eine Konfigurationsdatei zu aktualisieren, muss Ihr Code außerdem Schreibberechtigungen für die Konfigurationsdatei und das Verzeichnis, in dem sie vorhanden ist.To update a configuration file, your code must additionally have write permissions for both the configuration file and the directory in which it exists.

Ein Codebeispiel finden Sie unter den OpenMappedExeConfiguration überladen.For a code example, see the OpenMappedExeConfiguration overload.

Gilt für: