Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe WebConfigurationManager

Fornece acesso a arquivos de configuração que se aplicam a aplicações web.

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.
Superior

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

O WebConfigurationManager classe permite que você para acessar as informações do computador e aplicativo.

Usando WebConfigurationManager é a melhor maneira para trabalhar com arquivos de configuração relacionados 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 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 pelo WebConfigurationManager. For <appSettings> and <connectionStrings>, you use the AppSettings and ConnectionStrings properties. 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 as definições de configuração em qualquer nível, para si mesmo ou para outros aplicativos ou computadores, local ou remotamente. Você usar um do open métodos fornecidos pelo WebConfigurationManager. 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. 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 . More advanced configuration handling is provided by the types SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroup, and 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 um modelo atribuído em grande parte. Consulte o ConfigurationSection classe para obter um exemplo de como estender um tipo de configuração padrão por meio de programação. Consulte o ConfigurationElement classe para obter um exemplo de como estender um tipo de configuração padrão usando o modelo atribuído em grande parte.

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

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

Se seu aplicativo precisar de acesso somente leitura para sua própria configuração, é recomendável usar o GetSection métodos. Esses métodos fornecem acesso para os valores de configuração armazenadas 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á em execução; Caso contrário, o parâmetro é ignorado e informações de configuração para o aplicativo em execução no momento são retornadas.

Você usar um do Save métodos para gravar informações de configuração. Observe que o usuário ou processo que 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.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

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 do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft