Compartilhar via


Editando Arquivos de Configuração ASP.NET

Dados de configuração do ASP.NET são armazenados em arquivos de texto XML, cada um nomeado Web.config.Arquivos Web.config podem aparecer em vários diretórios em aplicativos ASP.NET.Cada arquivo web.config aplica configurações para seu próprio diretório e todos os diretórios filho abaixo dele.Configurações em diretórios filho podem, opcionalmente, substituir ou modificar as configurações que estão especificadas nos diretórios pai.A raiz da hierarquia de configuração do ASP.NET é systemroot\Microsoft.NET\Framework\versionNumber\CONFIG\Web.config, que inclui configurações que se aplicam a todos os aplicativos ASP.NET que executar uma versão específica do Microsoft .NET Framework.Porque cada aplicativo ASP.NET herda configurações padrão do arquivo Web.config raiz, você precisará criar arquivos Web.config somente para as configurações que substituem as configurações padrão.

Estrutura do Arquivo de Configuração

Cada arquivo de configuração contém aninhadas marcas e submarcas XML com atributos que especificam as definições de configuração.Todas as informações de configuração está entre as marcas da raiz XML <configuration> e </configuration>.Informações de configuração entre essas Rótulos são agrupadas em duas áreas principais: a área de declaração do manipulador de seção de configuração e a área configurações da seção de configuração.Para obter mais informações, consulte ASP.NET Configuration File Structure (Sections and Section Handlers).

Editando Definições de Configuração

Porque eles são arquivos XML em texto sem-formatação, você pode criar ou editar as configurações nos seguintes aspectos:

Com diferenciação de maiúsculas e minúsculas

Como as marcas devem ser XML bem-formados, as marcas, submarcas, e atributos diferenciam maiúsculas de minúsculas.Nomes de marca e nomes de atributo são Camel-cased, o que significa que o primeiro caractere de um nome de marca é minúsculo e a primeira letra de qualquer palavras ou palavras concatenadas subsequentes é maiúscula.Na maioria dos casos, valores de atributo de sequência de caracteres são Pascal-case, o que significa que o primeiro caractere é maiúsculo e a primeira letra das ou quaisquer palavras concatenadas subsequentes é maiúscula.As exceções são true e false, que são sempre letras minúsculas.

Seções personalizadas

A infraestrutura de configuração do ASP.NET faz não suposições sobre os tipos de dados de configuração que a infraestrutura oferece suporte.Classes de manipulador de seção de configuração processam todos os dados web.config.Você pode usar os manipuladores seção de configuração predefinidos fornecidos com o .NET Framework, ou você pode criar seus próprios manipuladores para processar dados de configuração personalizados.

Para obter mais informações sobre como criar tipos de configuração personalizada, consulte Como: Criar usando ConfigurationSection Custom configuração Sections.

Editando Arquivos de Configuração Remota

A API de configuração do ASP.NET permite que o aplicativo modifique os arquivos de configuração em um computador remoto.Em particular, você pode modificar o Machine.config ou um arquivo Web.config em qualquer aplicativo Serviços de Informações da Internet (IIS) da Microsoft, ou suas pastas filho em um computador remoto.Se o arquivo web.config não existir, os dados retornados de configuração consistem completamente de configurações herdadas que se aplicam ao caminho especificado.Se seu aplicativo solicita uma atualização nesses dados de configuração retornados, um novo arquivo é criado.Para obter mais informações, consulte Editando Arquivos de Configuração remotos do ASP.NET e Como: acesso e modificar arquivos de configuração ASP.NET remotamente.

Alterações de Configuração Causa uma Reinicialização do Domínio de Aplicativo

As alterações às definições de configuração nos arquivos Web.config indiretamente faz o domínio de aplicativo reiniciar.Esse comportamento ocorre por design.Opcionalmente, você pode usar o atributo configSource para referenciar arquivos externos de configuração que não causam uma reinicialização quando uma alteração é feita.Para mais informações, consulte configSource em Atributos de Geral herdados por elementos de seção.

Tentar alterar um arquivo de configuração por alguém que não tem permissão para editar o arquivo não causará nenhuma reinicialização do domínio de aplicativo.

Para obter mais informações, consulte Managing Changes to Configuration Settings.

Consulte também

Tarefas

Como: acesso e modificar arquivos de configuração ASP.NET remotamente

Como: Criar usando ConfigurationSection Custom configuração Sections

Conceitos

Protegendo configuração ASP.NET

Editando Arquivos de Configuração remotos do ASP.NET

Managing Changes to Configuration Settings

Referência

Ferramentas.NET Framework

Outros recursos

Administrando ites da Web do ASP.NET

Configurando aplicativos