ConfigurationManager.OpenMappedMachineConfiguration Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ConfigurationManager.cs

Öffnet die Computerkonfigurationsdatei als Configuration-Objekt, das die angegebene Dateizuordnung verwendet.

public:
 static System::Configuration::Configuration ^ OpenMappedMachineConfiguration(System::Configuration::ConfigurationFileMap ^ fileMap);

public static System.Configuration.Configuration OpenMappedMachineConfiguration (System.Configuration.ConfigurationFileMap fileMap);

static member OpenMappedMachineConfiguration : System.Configuration.ConfigurationFileMap -> System.Configuration.Configuration

Public Shared Function OpenMappedMachineConfiguration (fileMap As ConfigurationFileMap) As Configuration

Parameter

fileMap

ConfigurationFileMap

Die Konfigurationsdatei, die statt der Standard-Anwendungskonfigurationsdatei verwendet werden soll.

Gibt zurück

Configuration

Die Computerkonfigurationsdatei.

Ausnahmen

ConfigurationErrorsException

Eine Konfigurationsdatei konnte nicht geladen werden.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die OpenMappedMachineConfiguration -Methode verwenden, um alle Abschnitte in der Konfigurationsdatei abzurufen.

   // Access the machine configuration file using mapping.
   // The function uses the OpenMappedMachineConfiguration 
   // method to access the machine configuration. 
   public static void MapMachineConfiguration()
   {
     // Get the machine.config file.
     Configuration machineConfig =
       ConfigurationManager.OpenMachineConfiguration();
     // Get the machine.config file path.
     ConfigurationFileMap configFile =
       new ConfigurationFileMap(machineConfig.FilePath);

     // Map the application configuration file to the machine 
     // configuration file.
     Configuration config =
       ConfigurationManager.OpenMappedMachineConfiguration(
         configFile);

     // Get the AppSettings section.
     AppSettingsSection appSettingSection =
       (AppSettingsSection)config.GetSection("appSettings");
     appSettingSection.SectionInformation.AllowExeDefinition =
         ConfigurationAllowExeDefinition.MachineToRoamingUser;

     // Display the configuration file sections.
     ConfigurationSectionCollection sections = 
       config.Sections;

     Console.WriteLine();
     Console.WriteLine("Using OpenMappedMachineConfiguration.");
     Console.WriteLine("Sections in machine.config:");

     // Get the sections in the machine.config.
     foreach (ConfigurationSection section in sections)
     {
         string name = section.SectionInformation.Name;
         Console.WriteLine("Name: {0}", name);
     }
   }

' Access the machine configuration file using mapping.
' The function uses the OpenMappedMachineConfiguration 
' method to access the machine configuration. 
Public Shared Sub MapMachineConfiguration()
    ' Get the machine.config file.
    Dim machineConfig As Configuration = _
        ConfigurationManager.OpenMachineConfiguration()
    ' Get the machine.config file path.
    Dim configFile _
        As New ConfigurationFileMap( _
            machineConfig.FilePath)

    ' Map the application configuration file 
    ' to the machine configuration file.
    Dim config As Configuration = _
        ConfigurationManager. _
        OpenMappedMachineConfiguration( _
            configFile)

    ' Get the AppSettings section.
    Dim appSettingSection As AppSettingsSection = _
        DirectCast(config.GetSection("appSettings"),  _
            AppSettingsSection)
    appSettingSection.SectionInformation. _
    AllowExeDefinition = _
        ConfigurationAllowExeDefinition. _
        MachineToRoamingUser

    ' Display the configuration file sections.
    Dim sections As  _
        ConfigurationSectionCollection = _
        config.Sections

    Console.WriteLine()
    Console.WriteLine( _
        "Using OpenMappedMachineConfiguration.")
    Console.WriteLine( _
        "Sections in machine.config:")

    ' Get the sections in the machine.config.
    For Each section _
        As ConfigurationSection In sections
        Dim name As String = _
            section.SectionInformation.Name
        Console.WriteLine("Name: {0}", name)
    Next

End Sub

Hinweise

Computerkonfigurationseinstellungen gelten für den gesamten Computer und alle Anwendungen, die sich darauf befinden, es sei denn, sie werden für die lokale Anwendung überschrieben. Computerkonfigurationseinstellungen werden aus der Machine.config-Datei der derzeit ausgeführten Version von .NET Framework gelesen. Die Machine.config Datei befindet sich im folgenden Unterverzeichnis:

%windir%\Microsoft.NET\Framework\version\config

Hinweis

Um das Configuration Objekt für eine Ressource abzurufen, muss Ihr Code über Leseberechtigungen für alle Konfigurationsdateien verfügen, von denen er Einstellungen erbt. Um eine Konfigurationsdatei zu aktualisieren, muss Ihr Code zusätzlich über Schreibberechtigungen sowohl für die Konfigurationsdatei als auch für das Verzeichnis verfügen, in dem er sich befindet. Es ist nicht möglich, auf die Machine.config-Datei für andere Versionen der .NET Framework zuzugreifen, die möglicherweise auf dem Computer installiert sind.

Weitere Informationen

• Configuration
• ConfigurationFileMap