ConfigurationManager.OpenMappedMachineConfiguration Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ConfigurationManager.cs

Abre o arquivo de configuração do computador como um objeto Configuration que usa o mapeamento de arquivo especificado.

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

Parâmetros

fileMap

ConfigurationFileMap

O arquivo de configuração a ser usado em vez do arquivo de configuração padrão do aplicativo.

Retornos

Configuration

O arquivo de configuração do computador.

Exceções

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração.

Exemplos

O exemplo de código a seguir mostra como usar o OpenMappedMachineConfiguration método para obter todas as seções no arquivo de configuração.

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

Comentários

As configurações do computador se aplicam a todo o computador e a todos os aplicativos que residem nele, a menos que sejam substituídos pelo aplicativo local. As configurações do computador são lidas no arquivo Machine.config da versão em execução atualmente do .NET Framework. O arquivo Machine.config está localizado no seguinte subdiretório:

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

Observação

Para obter o Configuration objeto de um recurso, seu código deve ter permissões de leitura em todos os arquivos de configuração dos quais herda as configurações. Para atualizar um arquivo de configuração, seu código também deve ter permissões de gravação para o arquivo de configuração e o diretório no qual ele existe. Não é possível acessar o arquivo Machine.config para outras versões do .NET Framework que podem ser instaladas no computador.

Confira também

• Configuration
• ConfigurationFileMap