WebConfigurationManager.GetWebApplicationSection(String) Método

Definição

Espaço de Nomes:
System.Web.Configuration
Assemblagem:
System.Web.dll

Recupera a secção de configuração especificada do ficheiro de configuração da aplicação 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 secção de configuração.

Devoluções

Object

O objeto de secção de configuração especificado, ou null se a secção não existir, ou um objeto interno se a secção não for acessível em tempo de execução.

Exceções

ConfigurationErrorsException

Um ficheiro de configuração válido não podia ser carregado.

Exemplos

O exemplo seguinte mostra como aceder à informação de configuração com o GetWebApplicationSection método.

Note

Este exemplo demonstra como usar o GetWebApplicationSection método para obter um ConfigurationSection objeto do ficheiro 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

Observações

Se GetWebApplicationSection for chamada dentro de uma aplicação Web, obtém a secção do ficheiro de configuração selecionada pelo sistema de acordo com a hierarquia de configuração da aplicação Web.

Podes ligar GetWebApplicationSection a partir de uma aplicação de cliente. Neste caso, recebe a secção padrão do ficheiro de configuração selecionada pelo sistema de acordo com a hierarquia de configuração do cliente. Normalmente, este é o ficheiro Machine.config, a menos que tenhas uma configuração mapeada. Para ficheiros de configuração de mapeamento, consulte os métodos de mapeamento descritos a seguir.

Note

O GetWebApplicationSection método é uma operação em tempo de execução que atua sobre a secção do ficheiro de configuração da aplicação localizada ao nível atual. O GetSection método, no entanto, não é uma operação em tempo de execução, mas atua sobre a secção especificada obtida através de um dos métodos para abrir os ficheiros de configuração.

Notas para Herdeiros

O valor de retorno deve ser lançado para o tipo de configuração esperado antes da utilização. Para evitar possíveis exceções de casting, deve usar uma operação de casting condicional como o as operador em C#.

Aplica-se a

Ver também