ConfigurationManager.OpenMappedExeConfiguration Méthode

Référence

Définition

Espace de noms:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.Configuration.dll

Paquet:: System.Configuration.ConfigurationManager v6.0.0

Paquet:: System.Configuration.ConfigurationManager v7.0.0

Paquet:: System.Configuration.ConfigurationManager v8.0.0

Paquet:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ouvre le fichier de configuration client spécifié en tant qu’objet Configuration.

Surcharges

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)	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.
OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)	Ouvre le fichier de configuration client spécifié en tant qu'objet Configuration utilisant le mappage de fichiers, l'option de préchargement et le niveau d'utilisateur spécifiés.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Source:: ConfigurationManager.cs

Source:: ConfigurationManager.cs

Source:: ConfigurationManager.cs

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.

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

Paramètres

fileMap: ExeConfigurationFileMap

Fichier de configuration à utiliser à la place du fichier de configuration par défaut de l’application.

userLevel: ConfigurationUserLevel

Une des valeurs d’énumération qui spécifie le niveau utilisateur pour lequel vous ouvrez la configuration.

Retours

Configuration

Objet de configuration.

Exceptions

ConfigurationErrorsException

Nous n’avons pas pu charger un fichier de configuration.

Exemples

L’exemple de code suivant montre comment utiliser la OpenMappedExeConfiguration méthode pour obtenir toutes les sections 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 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

Remarques

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

Notes

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

Voir aussi

S’applique à

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Source:: ConfigurationManager.cs

Source:: ConfigurationManager.cs

Source:: ConfigurationManager.cs

Ouvre le fichier de configuration client spécifié en tant qu'objet Configuration utilisant le mappage de fichiers, l'option de préchargement et le niveau d'utilisateur spécifiés.

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

Paramètres

fileMap: ExeConfigurationFileMap

Fichier de configuration à utiliser au lieu du fichier de configuration par défaut de l’application.

userLevel: ConfigurationUserLevel

Une des valeurs d’énumération qui spécifie le niveau utilisateur pour lequel vous ouvrez la configuration.

preLoad: Boolean

true pour précharger tous les groupes de sections et toutes les sections ; sinon, false.

Retours

Configuration

Objet de configuration.

Exceptions

ConfigurationErrorsException

Nous n’avons pas pu charger un fichier de configuration.

Remarques

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

Notes

Pour obtenir un exemple de code, consultez la OpenMappedExeConfiguration surcharge.

S’applique à

Partager via

ConfigurationManager.OpenMappedExeConfiguration Méthode

Définition

Surcharges

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires