Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ConfigurationManager.OpenMappedExeConfiguration méthode (ExeConfigurationFileMap, ConfigurationUserLevel)

 

Date de publication : novembre 2016

Ouvre le fichier de configuration client spécifié en tant qu’objet Configuration qui utilise le mappage de fichier et le niveau utilisateur spécifiés.

Espace de noms:   System.Configuration
Assembly:  System.Configuration (dans System.Configuration.dll)

public static Configuration OpenMappedExeConfiguration(
	ExeConfigurationFileMap fileMap,
	ConfigurationUserLevel userLevel
)

Paramètres

fileMap
Type: System.Configuration.ExeConfigurationFileMap

Objet ExeConfigurationFileMap qui référence le fichier de configuration à utiliser à la place du fichier de configuration par défaut de l’application.

userLevel
Type: System.Configuration.ConfigurationUserLevel

Objet ConfigurationUserLevel pour lequel vous ouvrez la configuration.

Valeur de retour

Type: System.Configuration.Configuration

Objet de configuration.

Exception Condition
ConfigurationErrorsException

Impossible de charger l’un des fichiers de configuration.

Le ConfigurationUserLevel objet détermine l’emplacement du fichier de configuration en cours d’ouverture. Il indique si le fichier n’a aucun niveau d’utilisateur (le fichier de configuration est dans le même répertoire que l’application) ou a un niveau par utilisateur (le fichier de configuration est un chemin d’accès des paramètres d’application déterminé par userLevel).

System_CAPS_noteRemarque

Pour obtenir le Configuration de l’objet d’une ressource, votre code doit disposer des autorisations sur tous les fichiers de configuration à partir de laquelle elle hérite des paramètres de lecture. Pour mettre à jour un fichier de configuration, votre code doit disposer de plus d’autorisations en écriture pour le fichier de configuration et le répertoire dans lequel il se trouve.

L’exemple de code suivant montre comment utiliser le OpenMappedExeConfiguration méthode pour obtenir toutes les sections qui sont contenues dans le fichier de configuration.


// 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 ConsoleEment 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);
}

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: