Elemento location (Esquema de configuración de ASP.NET)

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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 Configuration <location> Settings y Locking Configuration Settings.

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

How to: Lock ASP.NET Configuration Settings

How to: Configure Specific Folders Using Location Settings

Referencia

Elemento configuration (Esquema de configuración general)

ConfigurationLocation

Conceptos

ASP.NET Configuration Overview

Securing Configuration

Locking Configuration Settings

Configuration <location> Settings

Otros recursos

Opciones de configuración de ASP.NET