Classe Configuration

The Configuration instância da classe representa a visão mesclada das definições de configuração que se aplicam a uma entidade física específica, sistema autônomo um computador ou para uma entidade lógica, sistema autônomo um aplicativo ou um site da Web. A entidade lógica especificada pode existir no computador local ou em um servidor remoto.

Quando nenhum arquivo de configuração existe para uma entidade especificada, o objeto Configuration representa os parâmetros de configuração padrão, conforme definido pelo arquivo Machine.config.

Você pode obter um Configuration objeto usando um dos métodos configuração aberta sistema autônomo definido pelo clsistema autônomoses seguintes:

• A classe ConfigurationManager, se sua entidade é um aplicativo cliente.

• A classe WebConfigurationManager, se sua entidade é um aplicativo da Web.

Para gerar um arquivo de configuração que representa as configurações herdadas de uma entidade especificada, use um dos métodos de configuração de salvar:

• O método Save para criar um novo arquivo de configuração.

• O método SaveAs para gerar um novo arquivo de configuração em outro local.

Observação:

Para habilitar o acesso aos parâmetros de configuração em um computador remoto, use o ferramenta de linha de comando Aspnet_regiis.Para obter mais informações sobre essa ferramenta, consulte Ferramenta de registro ASP.NET IIS (Aspnet_regiis.exe).Para obter informações sobre como criar e acessar personalizado configuração configurações diferentes de seções intrínsecas incluídas no .NET estrutura, consulte o ConfigurationSection.

The Configuration é a classe que permite o acesso programático para edição de arquivos de configuração. Usar um dos métodos abertos fornecidos pelo WebConfigurationManager para aplicativos da Web ou por ConfigurationManager para aplicativos cliente. Esses métodos irão retornar um objeto Configuration, que, por sua vez, fornece os métodos e propriedades necessários para manipular os arquivos de configuração subjacente.Você pode acessar esses arquivos para ler ou gravar sistema autônomo explicado a seguir.

Usar GetSection ou GetSectionGroup ler as informações de configuração. Observe que o usuário ou processo que lê deve ter as seguintes permissões:

• Permissão de leitura no arquivo de configuração no nível de hierarquia de configuração corrente.

• Ler permissões no pai todos os arquivos de configuração.

Se seu aplicativo precisa de acesso somente leitura à sua própria configuração, é recomendável que usar o GetSection métodos sobrecarregados em caso de aplicativos da Web. Ou o GetSection método no caso de aplicativos cliente.

Esses métodos fornecem acesso aos valores de configuração em cache para o aplicativo corrente, que tem um desempenho melhor do que o Configuration classe.

Observação:
Se você usar um estático GetSection método que assume um parâmetro de caminho, o parâmetro path deve se referir ao aplicativo em que o código está sendo executado, a outra forma o parâmetro é ignorado e informações de configuração para o aplicativo executado no momento são retornadas.

Usar um do Save métodos para gravar as informações de configuração. Observe que o usuário ou processo grava deve ter as seguintes permissões:

• Permissão de gravar no arquivo de configuração e do diretório no nível de hierarquia de configuração corrente.

• Ler permissões em todos os arquivos de configuração.

O exemplo de código a seguir demonstra como usar o Configuration classe para criar um arquivo de configuração que contenha uma seção personalizada.

// Create a custom section.staticvoid CreateSection()
{
    try
    {

        CustomSection customSection;

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

        // Create the section entry  // in <configSections> and the // related target section in <configuration>.if (config.Sections["CustomSection"] == null)
        {
            customSection = new CustomSection();
            config.Sections.Add("CustomSection", customSection);
            customSection.SectionInformation.ForceSave = true;
            config.Save(ConfigurationSaveMode.Full);

            Console.WriteLine("Section name: {0} created",
                customSection.SectionInformation.Name);

        }
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine(err.ToString());
    }

}

Esta é a definição da seção personalizada usadas pelo exemplo anterior.

// Define a custom section.publicsealedclass CustomSection :
    ConfigurationSection
{

    publicenum Permissions
    {
        FullControl = 0,
        Modify = 1,
        ReadExecute = 2,
        Read = 3,
        Write = 4,
        SpecialPermissions = 5
    }

    public CustomSection()
    {

    }

    [ConfigurationProperty("fileName", 
        DefaultValue = "default.txt")]
    [StringValidator(InvalidCharacters = " ~!@#$%^&*()[]{}/;'\"|\\",
               MinLength = 1, MaxLength = 60)]
    public String FileName
    {
        get
        {
            return (String)this["fileName"];
        }
        set
        {
            this["fileName"] = value;
        }
    }

    [ConfigurationProperty("maxIdleTime", DefaultValue="1:30:30")]
    public TimeSpan MaxIdleTime
    {
        get
        {
            return (TimeSpan)this["maxIdleTime"];
        }
        set
        {
            this["maxIdleTime"] = value;
        }
    }


    [ConfigurationProperty("permission", 
        DefaultValue = Permissions.Read)]
    public Permissions Permission
    {
        get
        {
            return (Permissions)this["permission"];
        }

        set
        {
            this["permission"] = value;
        }

    }

}

A seguir está um trecho de configuração conforme é usado pelo exemplo anterior.

<?xml version="1.0" encoding="utf-8"?>

<configuration>

  <configSections>
    <section name="CustomSection" type="Samples.AspNet.CustomSection, 
      Configuration, Version=1.0.0.0, Culture=neutral, 
      PublicKeyToken=null" allowDefinition="Everywhere" 
      allowExeDefinition="MachineToApplication" 
      restartOnExternalChanges="true" />
  </configSections>
    <CustomSection fileName="default.txt" maxIdleTime="01:30:30"
      permission="Read" />

</configuration>

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referência

Outros recursos