Classe WebConfigurationManager
TOC
Recolher sumário
Expandir sumário
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

Classe WebConfigurationManager

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

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

public static class WebConfigurationManager

The WebConfigurationManager classe permite que você acesso informações sobre o computador e o aplicativo.

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

Seu aplicativo pode estender o System.Configuration tipos ou usá-las 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 pela WebConfigurationManager. For <appSettings> e <connectionStrings>, você usa o AppSettings e ConnectionStrings Propriedades. Esses métodos realizam operações somente leitura, use uma única instância em cache de configuração e com vários threads são ciente.

    • Accessing configuration files .Seu aplicativo pode ler e gravar configurações de configuração em qualquer nível para si mesmo ou para outros aplicativos ou computadores, local ou remotamente.Usar um do open métodos fornecidos pela 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 gravar e recriar os dados de configuração sempre que um arquivo for aberto.

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

  • Extending configuration standard types .Você também pode fornecer seus elementos de configuração personalizada, estendendo sistema autônomo tipos de configuração padrão sistema autônomo, por exemplo, ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty, e ConfigurationSection usando uma programação ou um modelo atribuído. 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.

Observações para Implementers:

The Configuration classe permite acesso programático para edição de arquivos de configuração. Usar um dos métodos abertos 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.Você pode acesso esses arquivos para ler ou gravar da seguinte maneira:

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. 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çãoObservação:

Se você usar um estático GetSection método que usa um path parâmetro, o parâmetro caminho deve se referir ao aplicativo no qual o código está sendo executado; caso contrário, o parâmetro será 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 a seguir mostra como acesso informações de configuração com o WebConfigurationManager método.

// Show the use of GetSection(string). // It gets the connectiobStrings section.// If called from within a client application,// the GetSection(string) gets the default connectionStrings// section from the machine.config.// If called from within a Web aplication it gets the// section from the configuration file located at the // application current level. staticvoid GetSection1()
{

    // 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();
}



System.Object
  System.Web.Configuration.WebConfigurationManager

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.

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

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2016 Microsoft