WebConfigurationManager.GetWebApplicationSection(String) Método

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

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

Exemplos

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

// 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.

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#.

Aplica-se a

Confira também

• ConfigurationSection