Elemento location (Esquema de configuración de ASP.NET)
Actualización: noviembre 2007
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.
Elemento configuration (Esquema de configuración general)
Elemento location (Esquema de configuración de ASP.NET)
<location
allowOverride="True|False"
path="path"
/>
Atributos y elementos
Las secciones siguientes describen los atributos, los elementos secundarios y los 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. |
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 requerido en cada archivo de configuración usado por Common Language Runtime y las aplicaciones de .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 directorios virtuales o físicos |
Requisitos |
Microsoft Internet Information Services (IIS) versión 5.0, 5.1 o 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
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
Referencia
Elemento configuration (Esquema de configuración general)