WebConfigurationManager.GetWebApplicationSection(String) Método

Definição

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

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

public:
 static System::Object ^ GetWebApplicationSection(System::String ^ sectionName);

public static object GetWebApplicationSection (string sectionName);

static member GetWebApplicationSection : string -> obj

Public Shared Function GetWebApplicationSection (sectionName As String) As Object

Parâmetros

sectionName

String

O nome da seção de configuração.

Retornos

Object

O objeto da seção da configuração especificado, null se a seção não existir ou ainda um objeto interno se a seção não estiver acessível no tempo de execução.

Exceções

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração válido.

Exemplos

O exemplo a seguir mostra como acessar informações de configuração com o GetWebApplicationSection método.

Observação

Este exemplo demonstra como usar o GetWebApplicationSection método para obter um ConfigurationSection objeto do arquivo de configuração padrão.

// Show the use of GetWebApplicationSection(string). 
// to get the connectionStrings section.
 static void GetWebApplicationSection()
 {

     // Get the default connectionStrings section,
     ConnectionStringsSection connectionStringsSection =
         WebConfigurationManager.GetWebApplicationSection(
         "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 connectionStrings]");
     while (connectionStringsEnum.MoveNext())
     {
         string name = connectionStrings[i].Name;
         Console.WriteLine("Name: {0} Value: {1}",
         name, connectionStrings[name]);
         i += 1;
     }

     Console.WriteLine();
 }

' Show the use of GetWebApplicationSection(string). 
' to access the connectionStrings section.
Shared Sub GetWebApplicationSection()
   
   ' Get the default connectionStrings section,
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetWebApplicationSection( _
     "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 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

Se GetWebApplicationSection for chamado de dentro de um aplicativo Web, ele obterá a seção do arquivo de configuração selecionado pelo sistema de acordo com a hierarquia de configuração do aplicativo Web.

Você pode chamar GetWebApplicationSection de dentro de um aplicativo cliente. Nesse caso, ele obtém a seção padrão do arquivo de configuração selecionado pelo sistema de acordo com a hierarquia de configuração do cliente. Normalmente, esse é o arquivo Machine.config, a menos que você tenha uma configuração mapeada em vigor. Para mapear arquivos de configuração, consulte os métodos de mapeamento descritos a seguir.

Observação

O GetWebApplicationSection método é uma operação em tempo de execução que atua na seção do arquivo de configuração do aplicativo localizado no nível atual. O GetSection método, no entanto, não é uma operação em tempo de execução, mas atua na seção especificada obtida por meio de um dos métodos para abrir os arquivos de configuração.

Notas aos Herdeiros

O valor retornado deve ser convertido no tipo de configuração esperado antes do uso. Para evitar possíveis exceções de conversão, você deve usar uma operação de conversão condicional como o as operador em C#.

Confira também

• ConfigurationSection