WebConfigurationManager.GetWebApplicationSection (Método)

public static Object GetWebApplicationSection (
	string sectionName
)

public static Object GetWebApplicationSection (
	String sectionName
)

public static function GetWebApplicationSection (
	sectionName : String
) : Object

No aplicable.

Parámetros

sectionName

Nombre de la sección de configuración.

Valor devuelto

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

Podría llamar a GetWebApplicationSection desde una aplicación cliente. En este caso, recibe la sección predeterminada del archivo de configuración seleccionado por el sistema según la jerarquía de configuración del cliente. Normalmente, éste es el archivo Machine.config, a menos que tenga una configuración asignada en la ubicación correspondiente. Para asignar los archivos de configuración, consulte los métodos de asignación descritos a continuación.

Nota:
El método GetWebApplicationSection es una operación en tiempo de ejecución que actúa sobre la sección del archivo de configuración de la aplicación situada en el nivel actual. El método GetSection, no obstante, no es una operación en tiempo de ejecución pero actúa sobre la sección especificada que se obtiene a través de uno de los métodos para abrir los archivos de configuración.

Notas para los implementadores: El valor devuelto se debe convertir al tipo de configuración esperado antes de utilizarlo. Debería utilizar una operación de conversión condicional, como el operador as en C# o la función TryCast en Visual Basic, para evitar las posibles excepciones de conversión.

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

Nota:
En este ejemplo se muestra cómo utilizar el método GetWebApplicationSection para obtener un objeto ConfigurationSection del archivo de configuración predeterminado. Aunque en el ejemplo aparece la sección connectionStrings, la manera recomendada de recuperar una cadena de conexión es con la propiedad ConnectionStrings.

// Show the use of GetWebApplicationSection(string). 
// If called from within a Web aplication it gets the
// section from the configuration file located at the 
// application current level.
// Its behavior is similar to GetSection(string)
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();
}

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework