WebConfigurationManager Classe

Definição

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Herança

Object

WebConfigurationManager

Exemplos

O exemplo seguinte mostra como aceder à informação 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();
}

' 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

Observações

A WebConfigurationManager aula permite-lhe aceder a informações informáticas e de aplicações.

Usar WebConfigurationManager é a forma preferida de trabalhar com ficheiros de configuração relacionados com aplicações Web. Para aplicações cliente, use a ConfigurationManager classe.

A sua aplicação pode estender os System.Configuration tipos ou usá-los diretamente para tratar da informação de configuração, conforme explicado na lista seguinte:

• Handling configuration. Para gerir a informação de configuração usando os tipos padrão, utiliza-se uma das seguintes abordagens:

  • Accessing a section. Para aceder à informação de configuração da sua aplicação, deve utilizar um dos GetSection métodos fornecidos por WebConfigurationManager. Para <appSettings> e <connectionStrings>, utiliza-se as AppSettings propriedades e ConnectionStrings . Estes métodos realizam operações apenas de leitura, utilizam uma única instância em cache da configuração e são conscientes de multithread.

  • Accessing configuration files. A sua aplicação pode ler e escrever definições de configuração a qualquer nível, para si própria ou para outras aplicações ou computadores, local ou remotamente. Utiliza um dos open métodos fornecidos por WebConfigurationManager. Estes métodos devolvem um Configuration objeto, que por sua vez fornece os métodos e propriedades necessários para lidar com os ficheiros de configuração subjacentes. Estes métodos realizam operações de leitura ou escrita e recriam os dados de configuração sempre que um ficheiro é aberto.

  • Advanced configuration. O tratamento de configurações mais avançado é fornecido pelos tipos SectionInformation, PropertyInformation, PropertyInformationCollectionElementInformation, , ContextInformation, ConfigurationSectionGroup, e ConfigurationSectionGroupCollection.

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

Notas para Herdeiros

A Configuration classe permite acesso programático para editar ficheiros de configuração. Utiliza um dos métodos abertos fornecidos por WebConfigurationManager. Estes métodos devolvem um Configuration objeto, que por sua vez fornece os métodos e propriedades necessários para lidar com os ficheiros de configuração subjacentes. Pode aceder a estes ficheiros para leitura ou escrita da seguinte forma:

Utiliza-se GetSection(String) ou GetSectionGroup(String) para ler informação de configuração. Note que o utilizador ou processo que lê deve ter as seguintes permissões:

• Permissão de leitura no ficheiro de configuração ao nível atual da hierarquia de configuração.

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

Se a sua aplicação precisar de acesso apenas de leitura à sua própria configuração, recomenda-se que utilize os GetSection métodos. Estes métodos fornecem acesso aos valores de configuração em cache para a aplicação atual, que tem melhor desempenho do que a Configuration classe.

Nota: Se usar um método estático GetSection que recebe um path parâmetro, o parâmetro path deve referir-se à aplicação em que o código está a correr; caso contrário, o parâmetro é ignorado e a informação de configuração da aplicação atualmente em execução é devolvida.

Utiliza-se um dos Save métodos para escrever informação de configuração. Note que o utilizador ou processo que escreve deve ter as seguintes permissões:

• Permissão de escrita no ficheiro de configuração e diretório ao nível atual da hierarquia de configuração.

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

Ver também

• Configuration
• ConfigurationManager
• ASP.NET Visão Geral da Configuração