ConfigurationManager.OpenMappedExeConfiguration Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Apre il file di configurazione client specificato come oggetto Configuration.

Overload

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)	Apre il file di configurazione client specificato come un oggetto Configuration che usa il mapping del file e il livello utente specificati.
OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)	Apre il file di configurazione client specificato come un oggetto Configuration che utilizza il mapping del file, il livello utente specificati e l'opzione di precaricamento.

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

Source:

ConfigurationManager.cs

Apre il file di configurazione client specificato come un oggetto Configuration che usa il mapping del file e il livello utente specificati.

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

Parametri

fileMap

ExeConfigurationFileMap

File di configurazione da usare anziché il file di configurazione predefinito dell'applicazione.

userLevel

ConfigurationUserLevel

Uno dei valori di enumerazione che specifica il livello utente per il quale si apre la configurazione.

Restituisce

Configuration

Oggetto di configurazione.

Eccezioni

ConfigurationErrorsException

Non è stato possibile caricare un file di configurazione.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il OpenMappedExeConfiguration metodo per ottenere tutte le sezioni contenute nel file di configurazione.

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

Commenti

L'oggetto ConfigurationUserLevel determina il percorso del file di configurazione da aprire. Indica se il file non ha alcun livello utente (il file di configurazione si trova nella stessa directory dell'applicazione) o ha un livello per utente (il file di configurazione si trova in un percorso delle impostazioni dell'applicazione determinato da userLevel).

Nota

Per ottenere l'oggetto Configuration per una risorsa, il codice deve disporre delle autorizzazioni di lettura per tutti i file di configurazione da cui eredita le impostazioni. Per aggiornare un file di configurazione, il codice deve inoltre disporre delle autorizzazioni di scrittura sia per il file di configurazione che per la directory in cui esiste.

Vedi anche

• ConfigurationUserLevel
• Configuration

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

Source:

ConfigurationManager.cs

Apre il file di configurazione client specificato come un oggetto Configuration che utilizza il mapping del file, il livello utente specificati e l'opzione di precaricamento.

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

Parametri

fileMap

ExeConfigurationFileMap

File di configurazione da usare al posto del file di configurazione predefinito dell'applicazione.

userLevel

ConfigurationUserLevel

Uno dei valori di enumerazione che specifica il livello utente per il quale si apre la configurazione.

preLoad

Boolean

true per precaricare tutti i gruppi di sezioni e tutte le sezioni; in caso contrario, false.

Restituisce

Configuration

Oggetto di configurazione.

Eccezioni

ConfigurationErrorsException

Non è stato possibile caricare un file di configurazione.

Commenti

L’oggetto ConfigurationUserLevel determina il percorso del file di configurazione aperto. Indica se il file non dispone di alcun livello utente (il file di configurazione si trova nella stessa directory dell'applicazione) o se dispone di un livello utente (il file di configurazione si trova nel percorso delle impostazioni dell'applicazione determinato da userLevel).

Nota

Per ottenere l'oggetto Configuration per una risorsa, il codice deve disporre delle autorizzazioni di lettura per tutti i file di configurazione da cui eredita le impostazioni. Per aggiornare un file di configurazione, il codice deve inoltre disporre delle autorizzazioni di scrittura sia per il file di configurazione che per la directory in cui esiste.

Per un esempio di codice, vedere l'overload di OpenMappedExeConfiguration.