INFO: ASP.NET Configuration Overview

Este artículo hace referencia al siguiente espacio de nombres de biblioteca de clases de Microsoft.NET Framework:

  • System.Configuration

Resumen

Este artículo proporciona una introducción al marco de trabajo de página ASP.NET.

Para obtener información general adicional acerca ASP.NET, consulte el siguiente artículo de Microsoft Knowledge Base:
305140 INFO: Guía básica de ASP.NET

Más información

La configuración implica todo, desde la configuración de la aplicación como conexiones de base de datos con detalles de seguridad e información sobre cómo se controlan los errores. Archivos de configuración proporcionan una ubicación para obtener información específica del equipo y específica de la aplicación que se puede cambiar sin tener que volver a compilar el código.

En este artículo se trata los siguientes temas de configuración:

Configuración: Novedades

A diferencia de la configuración de la aplicación de páginas Active Server (ASP) que se almacena en la metabase de Microsoft Internet Information Services (IIS), los valores de configuración de ASP.NET se almacenan en archivos de lenguaje de marcado Extensible (XML, Extensible Markup Language). Esto proporciona las siguientes ventajas cuando se necesita cambiar los valores de configuración e implementar aplicaciones:
  • Archivos de configuración de ASP.NET se almacenan en el mismo directorio que el contenido del sitio. Durante la implementación, sólo es necesario copiar el directorio de contenido para obtener tanto el contenido como la configuración de la aplicación.
  • Puede utilizar editores de texto estándar para modificar archivos de configuración. Esto facilita cambiar valores de configuración tanto local como remotamente.
  • Los archivos de configuración son extensibles; como resultado, puede agregar sus propios valores de configuración personalizados.
  • El sistema detecta automáticamente los cambios en los archivos de configuración de ASP.NET. No es necesario reiniciar IIS ni el servidor Web para que surta efecto la configuración.

Jerarquía de configuración y formato de archivo

Hay dos tipos de archivos de configuración que deben preocuparle para las aplicaciones ASP.NET: Machine.config y Web.config. Ambos archivos están basados en XML y contienen secciones de configuración similares. Sin embargo, el archivo Machine.config contiene información de configuración acerca de todas las aplicaciones .NET para una versión específica del marco, mientras que los archivos Web.config contienen valores de configuración más granulares acerca de determinadas aplicaciones de ASP.NET. El texto en los archivos Machine.config y Web.config distingue mayúsculas de minúsculas.

Para obtener más información acerca del formato de los archivos de configuración de ASP.NET, consulte el tema siguiente en la documentación del Kit de desarrollo de Software (SDK) de.NET Framework:
Formato de archivos de configuración de ASP.NET
http://msdn2.microsoft.com/en-us/library/ackhksh7(vs.71).aspx
Cuando se solicita una página .aspx, los archivos de configuración se compilan de tal manera que un valor de configuración en un archivo Web.config almacenado en un subdirectorio reemplaza un valor en un archivo Web.config en un directorio de aplicación, que reemplaza la configuración en el nivel de sitio Web y en el archivo Machine.config. Una vez compilados los valores de configuración, se almacenan en caché para las solicitudes futuras hasta que se modifica uno de los archivos de configuración.

La tabla siguiente muestra las ubicaciones de archivos de configuración de ejemplo para la dirección URL http://myserver/myapplication/mydir/mypage.aspx:

Nivel deRuta de acceso
Opciones de configuración para esta versión de la de.NET FrameworkWinnt\Microsoft.net\Framework\v.version\Config\Machine.config
Configuración del sitio WebInetpub\Wwwroot\Web.config
Configuración de la aplicaciónInetpub\Wwwroot\Myapplication\Web.config
Configuración del subdirectorioInetpub\Wwwroot\Myapplication\Mydir\Web.config

Un archivo Web.config en cualquier nivel es opcional, pero es necesario un archivo Machine.config.

Para obtener más información acerca de la jerarquía de configuración, consulte el tema siguiente en la documentación del SDK de.NET Framework:
Arquitectura de configuración jerárquica
http://msdn.microsoft.com/en-us/library/aa720128(v=vs.71).aspx
Para aplicar la configuración a determinados recursos, utilice una etiqueta < ubicación > con un atributo path adecuado. Puede utilizar el atributo de ruta de acceso para identificar un archivo o directorio secundario específico al que se aplican las opciones de configuración únicas.

Para obtener más información acerca de la etiqueta < ubicación > , consulte el tema siguiente en la documentación del SDK de.NET Framework:

Secciones de configuración de ASP.NET

Las secciones de configuración de ASP.NET están contenidas en la sección < system.web > , que se encuentra en la etiqueta < configuration > :
   <configuration>      <appSettings></appSettings>
<system.web>
...
<webServices></webServices>
</system.web>
</configuration>

La tabla siguiente enumeran todas las secciones de configuración de ASP.NET:

SecciónDescripción
Configura valores personalizados para una aplicación. La configuración de esta sección puede compararse con las variables de aplicación.
Configura el modo de autenticación para determinar qué tipo de autenticación que utilice.
Configura el soporte de autorización y controla el acceso de cliente a los recursos de direcciones URL.
Configura las opciones del componente browser capabilities.
Configura todas las opciones de compilación que utiliza ASP.NET.
Proporciona información acerca de los mensajes de error personalizados para una aplicación ASP.NET.
Configura las opciones de globalización de la aplicación.
Asigna solicitudes de URL entrantes a las clases IHttpHandler .
Agrega, quita o borra módulos HTTP dentro de una aplicación.
Configura las opciones de tiempo de ejecución HTTP de ASP.NET.
Controla la identidad de la aplicación Web.
Configura las claves usadas para el cifrado y descifrado de los datos de cookie de autenticación de formularios. Esta sección permite configurar una clave de validación que realice comprobaciones de autenticación de mensaje en los datos de estado de vista y los vales de autenticación de formularios.
Identifica valores de configuración específicos de la página.
Configura los valores del modelo de proceso ASP.NET en sistemas servidores Web de IIS. Tenga en cuenta que sólo puede utilizar esta etiqueta en el archivo Machine.config.
Define las asignaciones válidas de los niveles de seguridad con nombre a archivos de directivas.
Configura el módulo de estado de sesión.
Configura el servicio de seguimiento ASP.NET.
Configura el conjunto de permisos de seguridad de acceso a código que se utiliza para ejecutar una aplicación determinada.
Controla la configuración de los servicios Web de ASP.NET.

Recuperar información de configuración

Puede recuperar información almacenada en el archivo de configuración, pero los métodos varían para los distintos valores de configuración. Algunos valores se exponen como propiedades de los objetos intrínsecos y otros son inaccesibles porque son valores internos de ASP.NET.

Por ejemplo, puede utilizar el código siguiente para tener acceso a la configuración de < browserCaps > mediante el objeto Request.Browser :

Microsoft Visual Basic .NET
Response.Write(Request.Browser.VBScript.ToString())
.NET de Microsoft Visual C#
Response.Write(Request.Browser.VBScript.ToString());
Para obtener más información acerca de cómo recuperar valores de configuración, consulte el tema siguiente en la documentación del SDK de.NET Framework:

Extender la sección de configuración

La funcionalidad de configuración de.NET Framework es totalmente extensible. Hay dos maneras en que puede extender la configuración:
  • Crear un controlador de sección de configuración personalizada.

    Para obtener información adicional acerca de cómo crear controladores de sección de configuración de ASP.NET personalizados, haga clic en el número de artículo siguiente para verlo en Microsoft Knowledge Base:
    309045 Cómo: crear un controlador de sección de configuración personalizado de ASP.NET en .NET Visual C#
  • Utilice la sección < appSettings > para almacenar datos específicos de la aplicación. Para obtener información sobre la sintaxis de la sección < appSettings > , consulte el tema siguiente en la documentación del SDK de.NET Framework:Para recuperar los valores de la sección < appSettings > , utilice el código siguiente en el archivo .config:
            <appSettings><add key="MySetting" value="Valuable Information" />
    </appSettings>

    A continuación, utilice el código siguiente para recuperar el valor:

    Nota: debe incluir el espacio de nombres System.Configuration para tener acceso a appSettings.

    Visual Basic .NET
        Label1.Text = ConfigurationSettings.AppSettings.Item("MySetting")
    .NET Visual C#
        Label1.Text = ConfigurationSettings.AppSettings["MySetting"];
Propiedades

Id. de artículo: 307626 - Última revisión: 22 ene. 2017 - Revisión: 1

Comentarios