ConfigurationUserLevel Enumeração

Definição

Espaço de Nomes:
System.Configuration
Assemblagem:
System.Configuration.dll

Usado para especificar qual ficheiro de configuração deve ser representado pelo objeto Configuration.

public enum class ConfigurationUserLevel
public enum ConfigurationUserLevel
type ConfigurationUserLevel = 
Public Enum ConfigurationUserLevel
Herança
Object
ValueType
Enum
ConfigurationUserLevel

Campos

Name Valor Description
None 0

Recebe o Configuration que se aplica a todos os utilizadores.
PerUserRoaming 10

Obtém o roaming Configuration que se aplica ao utilizador atual.
PerUserRoamingAndLocal 20

Obtém o local Configuration que se aplica ao utilizador atual.

Exemplos

O exemplo seguinte mostra como usar a ConfigurationUserLevel enumeração.


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Configuration;
using System.Collections;
using System.Collections.Specialized;
using System.Diagnostics;
using System.Text;

public class UsingConsoleConfigElement
{

    static void GetConfigurationFile()
    {

        try
        {
            // Get the current application configuration file.
            Configuration config =
              ConfigurationManager.OpenExeConfiguration(
               ConfigurationUserLevel.None);

            Console.WriteLine(config.FilePath);
        }
        catch (ConfigurationErrorsException e)
        {
            Console.WriteLine("[Exception error: {0}]",
                e.ToString());
        }
    }

    // Get the roaming configuration file associated 
    // with the current user.
    static void GetRoamingConfigurationFile()
    {

        try
        {
            // Get the roaming configuration 
            // that applies to the current user.
            Configuration roamingConfig =
              ConfigurationManager.OpenExeConfiguration(
               ConfigurationUserLevel.PerUserRoaming);

            Console.WriteLine(roamingConfig.FilePath);
        }
        catch (ConfigurationErrorsException e)
        {
            Console.WriteLine("[Exception error: {0}]",
                e.ToString());
        }
    }

    static void Main(string[] args)
    {
        Console.Write("Roaming configuration file: ");
        GetRoamingConfigurationFile();
        Console.WriteLine();
        Console.Write("Configuration file: ");
        GetConfigurationFile();
        Console.WriteLine("Enter any key to exit");
        Console.ReadLine();
    }
}

Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.Configuration
Imports System.Collections
Imports System.Collections.Specialized
Imports System.Diagnostics


Public Class UsingConsoleConfigElement

    Private Shared Sub GetConfigurationFile()

        Try
            ' Get the current application configuration file.
            Dim config As Configuration = _
                ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None)

            Console.WriteLine(config.FilePath)

        Catch e As ConfigurationErrorsException
            Console.WriteLine("[Exception error: {0}]", e.ToString())
        End Try


    End Sub

    ' Get the roaming configuration file associated 
    ' with the current user.
    Private Shared Sub GetRoamingConfigurationFile()


      Try
          ' Get the roaming configuration 
          ' that applies to the current user.
            Dim roamingConfig As Configuration = _
                ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.PerUserRoaming)

          Console.WriteLine(roamingConfig.FilePath)

      Catch e As ConfigurationErrorsException
          Console.WriteLine("[Exception error: {0}]", e.ToString())
      End Try


    End Sub

    
    Shared Sub Main(ByVal args() As String)
        Console.Write("Roaming configuration file: ")
            GetRoamingConfigurationFile()
            Console.WriteLine()
        Console.Write("Configuration file: ")
            GetConfigurationFile()
        Console.WriteLine("Enter any key to exit")
        Console.ReadLine()
    End Sub
End Class

Observações

Use ConfigurationUserLevel para especificar qual ficheiro de configuração será representado pelo objeto Configuration devolvido por ConfigurationManager.OpenExeConfiguration e WebConfigurationManager.OpenMachineConfiguration.

Os ficheiros de configuração da aplicação estão no mesmo diretório que a aplicação e têm o mesmo nome, mas com uma extensão .config. Por exemplo, o ficheiro de configuração para C:\System\Public.exe é C:\System\Public.exe.config.

As aplicações usam uma configuração global que se aplica a todos os utilizadores, configurações separadas que se aplicam a utilizadores individuais e configurações que se aplicam a utilizadores em roaming.

Aplica-se a

Ver também