WebConfigurationManager.GetWebApplicationSection(String) Método

Definición

Espacio de nombres:

System.Web.Configuration

Ensamblado:

System.Web.dll

Recupera la sección de configuración especificada del archivo de configuración de la aplicación Web actual.

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

Nombre de la sección de configuración.

Devoluciones

Object

Objeto de sección de configuración especificado; o bien, null si la sección no existe; o bien, un objeto interno si no se puede obtener acceso a la sección en tiempo de ejecución.

Excepciones

ConfigurationErrorsException

No se pudo cargar un archivo de configuración válido.

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el GetWebApplicationSection método .

Nota

En este ejemplo se muestra cómo usar el GetWebApplicationSection método para obtener un ConfigurationSection objeto del archivo de configuración predeterminado.

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

Comentarios

Si GetWebApplicationSection se llama desde dentro de una aplicación web, obtiene la sección del archivo de configuración seleccionado por el sistema según la jerarquía de configuración de la aplicación web.

Puede llamar GetWebApplicationSection desde dentro de una aplicación cliente. En este caso, obtiene la sección predeterminada del archivo de configuración seleccionado por el sistema según la jerarquía de configuración de cliente. Normalmente, este es el archivo Machine.config, a menos que tenga una configuración asignada. Para los archivos de configuración de asignación, consulte los métodos de asignación que se describen a continuación.

Nota

El GetWebApplicationSection método es una operación en tiempo de ejecución que actúa en la sección del archivo de configuración de la aplicación ubicado en el nivel actual. Sin embargo, el GetSection método no es una operación en tiempo de ejecución, sino que actúa en la sección especificada obtenida a través de uno de los métodos para abrir los archivos de configuración.

Notas a los desarrolladores de herederos

El valor devuelto debe convertirse al tipo de configuración esperado antes de usarlo. Para evitar posibles excepciones de conversión, debe usar una operación de conversión condicional como el as operador en C#.

Consulte también

• ConfigurationSection