Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe WebConfigurationManager

Provides access to configuration files as they apply to Web applications.

System.Object
  System.Web.Configuration.WebConfigurationManager

Namespace:  System.Web.Configuration
Assembly:  System.Web (em System.Web.dll)

public static class WebConfigurationManager

O tipo WebConfigurationManager expõe os membros a seguir.

  NomeDescrição
Propriedade públicaMembro estáticoAppSettingsObtém as configurações do aplicativo do site da Web.
Propriedade públicaMembro estáticoConnectionStringsObtém as seqüências de conexão do site da Web.
Início

  NomeDescrição
Método públicoMembro estáticoGetSection(String)Recupera a seção de configuração especificado do arquivo de configuração do aplicativo da Web atual.
Método públicoMembro estáticoGetSection(String, String)Recupera a seção de configuração especificado do arquivo de configuração do aplicativo da Web no local especificado.
Método públicoMembro estáticoGetWebApplicationSectionRecupera a seção de configuração especificado do arquivo de configuração do aplicativo da Web atual.
Método públicoMembro estáticoOpenMachineConfiguration()Abre o arquivo de configuração de máquina do computador atual como um Configuration o objeto para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMachineConfiguration(String)Abre o arquivo de configuração de máquina do computador atual como um Configuration o objeto para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMachineConfiguration(String, String)Abre o arquivo de configuração de máquina especificado no servidor especificado como um Configuration o objeto para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMachineConfiguration(String, String, IntPtr)Abre o arquivo de configuração de máquina especificado no servidor especificado como um Configuration o objeto, usando o contexto de segurança especificado para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMachineConfiguration(String, String, String, String)Abre o arquivo de configuração de máquina especificado no servidor especificado como um Configuration o objeto, usando o contexto de segurança especificado para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMappedMachineConfiguration(ConfigurationFileMap)Abre o arquivo de configuração da máquina como um Configuration objeto, usando o arquivo especificado, o mapeamento para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMappedMachineConfiguration(ConfigurationFileMap, String)Abre o arquivo de configuração da máquina como um Configuration objeto usando o mapeamento do arquivo especificado e o local para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMappedWebConfiguration(WebConfigurationFileMap, String)Abre o arquivo de configuração de aplicativo da Web especificado como um Configuration objeto usando o mapeamento do arquivo especificado e o caminho virtual para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMappedWebConfiguration(WebConfigurationFileMap, String, String)Abre o arquivo de configuração de aplicativo Web especificado como um Configuration objeto usando o mapeamento do arquivo especificado, o caminho virtual e o nome do site para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)Abre o arquivo de configuração de aplicativo da Web especificado como um Configuration objeto usando o arquivo especificado, mapeamento, o caminho virtual, o nome do site e o local para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenWebConfiguration(String)Abre o arquivo de configuração de aplicativo da Web como um Configuration objeto usando o caminho virtual especificado para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenWebConfiguration(String, String)Abre o arquivo de configuração de aplicativo da Web como um Configuration objeto usando o especificado nome virtual de caminho e o site para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenWebConfiguration(String, String, String)Abre o arquivo de configuração de aplicativo da Web como um Configuration objeto usando o caminho virtual especificado, o nome do site e o local para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenWebConfiguration(String, String, String, String)Abre o arquivo de configuração de aplicativo da Web como um Configuration objeto usando o caminho virtual especificado, o nome do site, o local e o servidor para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenWebConfiguration(String, String, String, String, IntPtr)Abre o arquivo de configuração de aplicativo da Web como um Configuration objeto usando o caminho virtual especificado, o nome do site, local, servidor e o contexto de segurança para permitir a leitura ou gravação de operações.
Método públicoMembro estáticoOpenWebConfiguration(String, String, String, String, String, String)Abre o arquivo de configuração de aplicativo da Web como um Configuration objeto usando o caminho virtual especificado, o nome do site, local, servidor e o contexto de segurança para permitir a leitura ou gravação de operações.
Início

O WebConfigurationManager classe lhe permite acessar informações de computador e aplicativo.

Usando WebConfigurationManager é a melhor maneira de trabalhar com arquivos de configuração relacionada a aplicativos da Web. Para aplicativos cliente, use o ConfigurationManager classe.

Seu aplicativo pode estender a System.Configuration tipos ou usá-los diretamente para manipular informações de configuração, conforme explicado na lista a seguir:

  • Handling configuration . Para lidar com as informações de configuração usando os tipos padrão, use uma das seguintes abordagens:

    • Accessing a section . Para acessar informações de configuração para seu aplicativo, você deve usar um do GetSection métodos fornecidos por WebConfigurationManager. Para <appSettings> e <connectionStrings>, você pode usar o AppSettings e ConnectionStrings Propriedades. Esses métodos realizar operações somente leitura, use uma única instância em cache da configuração e são multithread ciente.

    • Accessing configuration files . Seu aplicativo pode ler e gravar configurações em qualquer nível para si ou para outros computadores, ou de aplicativos, localmente ou remotamente. Use um do open métodos fornecidos por WebConfigurationManager. These methods will return a Configuration object, which in turn provides the required methods and properties to handle the underlying configuration files. Esses métodos executam leitura ou operações de gravação e recriar os dados de configuração sempre que um arquivo for aberto.

    • Advanced configuration . Manipulação de configuração mais avançada é fornecida pelos tipos de SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroup, e ConfigurationSectionGroupCollection.

  • Extending configuration standard types . Você também pode fornecer os elementos de configuração personalizada, estendendo os tipos de configuração padrão como ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty, e ConfigurationSection por meio de uma programação ou modelo atribuída. Consulte o ConfigurationSection classe para obter um exemplo de como estender um tipo de configuração padrão programaticamente. Consulte o ConfigurationElement classe para obter um exemplo de como estender um tipo de configuração padrão usando o modelo atribuída.

Observações para implementadores

O Configuration classe permite acesso programático para editar arquivos de configuração. Você usar um dos métodos open fornecidos por WebConfigurationManager. These methods will return a Configuration object, which in turn provides the required methods and properties to handle the underlying configuration files. Você pode acessar esses arquivos para leitura ou gravação da seguinte maneira:

Você pode usar GetSection ou GetSectionGroup para ler 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 atual.

  • Permissões de leitura no pai todos os arquivos de configuração.

Se seu aplicativo precisar de acesso somente leitura para a sua própria configuração, é recomendável usar o GetSection métodos. Esses métodos fornecem acesso para os valores de configuração em cache para o aplicativo atual, que tem um desempenho melhor que o Configuration classe.

ObservaçãoObservação

Se você usar um estático GetSection método que usa um path parâmetro, o parâmetro path deve se referir ao aplicativo no qual o código está sendo executado. Caso contrário, o parâmetro é ignorado e informações de configuração para o aplicativo em execução no momento são retornadas.

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

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

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

O exemplo a seguir mostra como acessar as informações de configuração com o

GetSection método.



        // Show how to use the GetSection(string). 
        // to access the connectionStrings section.
        static void GetConnectionStringsSection()
        {

            // Get the connectionStrings section.
            ConnectionStringsSection connectionStringsSection =
                WebConfigurationManager.GetSection("connectionStrings")
                as ConnectionStringsSection;

            // Get the connectionStrings key,value pairs collection.
            ConnectionStringSettingsCollection connectionStrings =
                connectionStringsSection.ConnectionStrings;

            // Get the collection enumerator.
            IEnumerator connectionStringsEnum =
                connectionStrings.GetEnumerator();

            // Loop through the collection and 
            // display the connectionStrings key, value pairs.
            int i = 0;
            Console.WriteLine("[Display the connectionStrings]");
            while (connectionStringsEnum.MoveNext())
            {
                string name = connectionStrings[i].Name;
                Console.WriteLine("Name: {0} Value: {1}",
                name, connectionStrings[name]);
                i += 1;
            }

            Console.WriteLine();
        }



.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Mostrar: