Crear opciones de configuración específicas de la aplicación y el directorio en una ASP.NET aplicación

En este artículo se describe cómo crear opciones de configuración específicas de la aplicación y de directorio en ASP.NET.

Versión del producto original:   ASP.NET
Número KB original:   815174

Resumen

El Web.config está en el directorio raíz de una ASP.NET aplicación. El Web.config especifica la información de configuración que es específica de la aplicación. También puede establecer las opciones de configuración por directorio. Hay dos maneras de hacerlo:

  • Distribuya variosWeb.config archivos a directorios de la aplicación. Agregue un archivoWeb.config en el directorio de aplicaciones de ASP.NET con configuraciones que invalide la configuración en un archivo deWeb.config de nivel superior o en el archivo de configuración del equipo del sistema (Machine.config).

  • Agregue la configuración por directorio o por archivo directamente al archivo Web.configaplicación. Este método usa un único archivoWeb.config para activar las opciones de configuración por directorio. También puede usar este método en el archivo Machine.config para forzar las opciones de configuración en aplicaciones web ASP.NET y, a continuación, para impedir que losWeb.configinvalidenMachine.config configuración.

Usar el elemento location en el Machine.config archivo

Para especificar la configuración que se aplica a una aplicación web o directorio, puede agregar el elemento al elemento de un archivo <location> <configuration>Machine.configsistema. Es útil al centralizar las opciones de configuración en un solo archivo. También es útil en entornos de hospedaje web para dar un mandato a opciones de configuración específicas en aplicaciones web individuales.

El <location> elemento contiene dos atributos y path allowOverride . El path atributo define el sitio o directorio virtual que cubren las opciones de configuración. Para especificar que la configuración del <location> elemento se aplique al sitio web predeterminado, establezca el atributo en path Default Web Site . Para especificar que la configuración se aplique a la aplicación denominada MyApp en el sitio web predeterminado, establezca path el atributo en Default Web Site/MyApp .

Cuando el atributo es false, losWeb.configen los directorios de la aplicación web no pueden invalidar la configuración especificada allowOverride en el <location> elemento. Es una configuración útil en entornos donde debe restringir a los programadores de aplicaciones en la forma en que configuran una aplicación web. En el ejemplo siguiente se muestra una parte de un Machine.config archivo. El archivo requiere autenticación para tener acceso a la aplicación MyApp en el sitio web predeterminado y no se puede invalidar mediante la configuración de un Web.config archivo.

<configuration>
    <location path="Default Web Site/MyApp" allowOverride="false">
        <system.web>
            <authorization>
                <allow users="?" />
            </authorization>
        </system.web>
    </location>
</configuration>

Usar el elemento location en el Web.config archivo

Para especificar la configuración que se aplica a una aplicación o directorio específicos, agregue el elemento al <location> elemento de una aplicación <configuration> Web.config archivo. El elemento normalmente contiene un elemento y otros elementos de configuración exactamente igual que los usa <location> <system.web> en el Web.config archivo. El atributo del elemento especifica el directorio virtual o el nombre de archivo donde se aplican path los elementos de configuración de <location> ubicación. En el ejemplo siguiente se muestra parte de una aplicación Web.config que especifica mensajes de error personalizados para el directorio virtual del foro.

<configuration>
    <location path="forum" >
        <system.web>
            <customErrors mode="RemoteOnly" defaultRedirect="forum-error.aspx">
                <error statusCode="404" redirect="forum-file-not-found.aspx" />
            </customErrors>
        </system.web>
    </location>
</configuration>

Referencias