Compartilhar via


WebConfigurationManager Classe

Definição

Fornece acesso a arquivos de configuração que se aplicam a aplicativos da Web.

public ref class WebConfigurationManager abstract sealed
public static class WebConfigurationManager
type WebConfigurationManager = class
Public Class WebConfigurationManager
Herança
WebConfigurationManager

Exemplos

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

Método GetSection.


// 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();
}
' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

Comentários

A WebConfigurationManager classe permite que você acesse informações de computador e aplicativo.

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

Seu aplicativo pode estender os System.Configuration tipos ou usá-los diretamente para lidar com as 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 as informações de configuração do aplicativo, você deve usar um dos GetSection métodos fornecidos pelo WebConfigurationManager. Para <appSettings> e <connectionStrings>, você usa as AppSettings propriedades e ConnectionStrings . Esses métodos executam operações somente leitura, usam uma única instância armazenada em cache da configuração e têm reconhecimento multithread.

    • Accessing configuration files. Seu aplicativo pode ler e gravar configurações em qualquer nível, para si mesmo ou para outros aplicativos ou computadores, local ou remotamente. Você usa um dos open métodos fornecidos por WebConfigurationManager. Esses métodos retornarão um Configuration objeto , que, por sua vez, fornece os métodos e as propriedades necessários para lidar com os arquivos de configuração subjacentes. Esses métodos executam operações de leitura ou gravação e recriam os dados de configuração sempre que um arquivo é aberto.

    • Advanced configuration. O tratamento de configuração mais avançado é fornecido pelos tipos SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroupe ConfigurationSectionGroupCollection.

  • Extending configuration standard types. Você também pode fornecer seus elementos de configuração personalizados estendendo os tipos de configuração padrão, como ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertye ConfigurationSection usando um modelo programático ou atribuído. Consulte a ConfigurationSection classe para obter um exemplo de como estender um tipo de configuração padrão programaticamente. Consulte a ConfigurationElement classe para obter um exemplo de como estender um tipo de configuração padrão usando o modelo atribuído.

Notas aos Herdeiros

A Configuration classe permite acesso programático para editar arquivos de configuração. Você usa um dos métodos abertos fornecidos por WebConfigurationManager. Esses métodos retornarão um Configuration objeto , que, por sua vez, fornece os métodos e as propriedades necessários para lidar com os arquivos de configuração subjacentes. Você pode acessar esses arquivos para leitura ou gravação da seguinte maneira:

Você usa GetSection(String) ou GetSectionGroup(String) 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 da hierarquia de configuração atual.

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

Se o aplicativo precisar de acesso somente leitura à sua própria configuração, é recomendável que você use os GetSection métodos. Esses métodos fornecem acesso aos valores de configuração armazenados em cache para o aplicativo atual, que tem melhor desempenho do que a Configuration classe .

Observação: se você usar um método estático GetSection que usa um path parâmetro, o parâmetro path deverá se referir ao aplicativo no qual o código está em execução; caso contrário, o parâmetro será ignorado e as informações de configuração do aplicativo em execução no momento serão retornadas.

Você usa um dos 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 no diretório no nível da hierarquia de configuração atual.

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

Propriedades

AppSettings

Obtém as configurações de aplicativo do site da Web.

ConnectionStrings

Obtém as cadeias de conexão do site da Web.

Métodos

GetSection(String)

Recupera a seção de configuração especificada do arquivo de configuração do aplicativo Web atual.

GetSection(String, String)

Recupera a seção de configuração especificada do arquivo de configuração do aplicativo Web no local especificado.

GetWebApplicationSection(String)

Recupera a seção de configuração especificada do arquivo de configuração do aplicativo Web atual.

OpenMachineConfiguration()

Abre o arquivo de configuração de computador no computador atual como um objeto Configuration para permitir a leitura ou gravação.

OpenMachineConfiguration(String)

Abre o arquivo de configuração de computador no computador atual como um objeto Configuration para permitir a leitura ou gravação.

OpenMachineConfiguration(String, String)

Abre o arquivo de configuração de computador no servidor especificado como um objeto Configuration para permitir operações de leitura ou gravação.

OpenMachineConfiguration(String, String, IntPtr)

Abre o arquivo de configuração de computador indicado no servidor especificado como um objeto Configuration usando o contexto de segurança para permitir operações de leitura ou gravação.

OpenMachineConfiguration(String, String, String, String)

Abre o arquivo de configuração de computador indicado no servidor especificado como um objeto Configuration usando o contexto de segurança para permitir operações de leitura ou gravação.

OpenMappedMachineConfiguration(ConfigurationFileMap)

Abre o arquivo de configuração de computador como um objeto Configuration, usando o mapeamento de arquivo especificado para permitir operações de leitura ou gravação.

OpenMappedMachineConfiguration(ConfigurationFileMap, String)

Abre o arquivo de configuração de computador como um objeto Configuration que usa o mapeamento e a localização do arquivo especificado para permitir operações de leitura ou gravação.

OpenMappedWebConfiguration(WebConfigurationFileMap, String)

Abre o arquivo de configuração de aplicativo Web especificado como um objeto Configuration usando o mapeamento de arquivo e o caminho virtual especificados para permitir operações de leitura ou gravação.

OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)

Abre o arquivo de configuração de aplicativo Web especificado como um objeto Configuration usando o mapeamento do arquivo definido, o caminho virtual e o nome do site para permitir operações de leitura ou gravação.

OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)

Abre o arquivo de configuração de aplicativo Web especificado como um objeto Configuration usando o mapeamento de arquivo especificado, o caminho virtual, o nome e o local do site para permitir operações de leitura ou gravação.

OpenWebConfiguration(String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual especificado para permitir operações de leitura ou gravação.

OpenWebConfiguration(String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o nome do site e o caminho virtual especificados para permitir operações de leitura ou gravação.

OpenWebConfiguration(String, String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, o nome do site e a localização especificados para permitir operações de leitura ou gravação.

OpenWebConfiguration(String, String, String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, o nome do site, a localização e o servidor especificados para permitir operações de leitura ou gravação.

OpenWebConfiguration(String, String, String, String, IntPtr)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, nome do site, local, servidor e contexto de segurança especificados para permitir operações de leitura ou gravação.

OpenWebConfiguration(String, String, String, String, String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, nome do site, local, servidor e contexto de segurança especificados para permitir operações de leitura ou gravação.

Aplica-se a

Confira também