Elemento location (Esquema de configuración de ASP.NET)
Especifica el recurso al que se aplican los valores de configuración secundarios y bloquea los valores de configuración, impidiendo que sean reemplazados por archivos de configuración secundarios.
Se trata de un elemento nuevo en .NET Framework versión 2.0.
<location
allowOverride="True|False"
path="path"
/>
Atributos y elementos
En las siguientes secciones se describen atributos, elementos secundarios y elementos primarios de este elemento.
Atributos
Atributo |
Descripción |
|---|---|
allowOverride |
Atributo Boolean opcional. Especifica si los valores de configuración pueden ser reemplazados por los valores de configuración de los archivos Web.config ubicados en los directorios secundarios. El valor predeterminado es True.. |
path |
Atributo String opcional. Especifica el recurso al que se aplican los valores de configuración incluidos. Si se usa location sin un atributo path, los valores de configuración se aplican al directorio actual y a todos los directorios secundarios. Si se usa location sin el atributo path y el valor de allowOverride es False, los valores de configuración no se pueden modificar mediante los archivos Web.config ubicados en los directorios secundarios. |
inheritInChildApplications |
Atributo Boolean opcional. Especifica si las aplicaciones existentes en los subdirectorios heredan los valores de configuración específicos de una ubicación determinada (como el directorio raíz de un sitio web). El valor predeterminado es True.. |
Elementos secundarios
El elemento location puede encerrar otros elementos, ya sea para aplicar valores de configuración a un recurso específico o para bloquearlos.
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework. |
Comentarios
El elemento location especifica el recurso al que se aplican los valores de configuración secundarios y se utiliza asimismo para bloquear los valores de configuración, impidiendo que sean reemplazados por archivos de configuración secundarios.
El elemento location puede encerrar otros elementos, ya sea para aplicar valores de configuración a un recurso específico o para bloquearlos. Para obtener más información, vea Configurar archivos y subdirectorios específicos y Bloquear opciones de configuración.
Ejemplo
En el ejemplo de código siguiente se muestra cómo permitir a un usuario anónimo obtener acceso a la página Logon.aspx.
<configuration>
<location path="Logon.aspx">
<system.web>
<authorization>
<allow users="?"/>
</authorization>
</system.web>
</location>
</configuration>
En el siguiente ejemplo de código se muestra cómo establecer en 128 KB el límite de tamaño de los archivos cargados, únicamente para la página especificada.
<configuration>
<location path="UploadPage.aspx">
<system.web>
<httpRuntime maxRequestLength="128"/>
</system.web>
</location>
</configuration>
En el siguiente ejemplo de código se muestra cómo evitar que los valores de configuración sean modificados por los archivos Web.config ubicados en directorios secundarios.
<configuration>
<location allowOverride="false"/>
</configuration>
Información de elemento
Controlador de la sección de configuración |
No se aplica. |
Miembro de configuración |
|
Ubicaciones configurables |
Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorio virtual o físico |
Requisitos |
Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vea también
Tareas
Cómo: Bloquear los valores de configuración de ASP.NET
Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Referencia
Elemento configuration (Esquema de configuración general)
Conceptos
Información general sobre la configuración de ASP.NET
Proteger la configuración de ASP.NET
Bloquear opciones de configuración
Configurar archivos y subdirectorios específicos