Элемент location (схема параметров ASP.NET)
Определяет ресурс, к которому применяются параметры дочерней конфигурации, и блокирует параметры конфигурации, запрещая переопределение параметров файлами дочерней конфигурации.
Этот элемент не использовался до .NET Framework версии 2.0.
<location
allowOverride="True|False"
path="path"
/>
Атрибуты и элементы
В следующих разделах описываются атрибуты, дочерние элементы и родительские элементы для данного элемента.
Атрибуты
Атрибут |
Описание |
|---|---|
allowOverride |
Необязательный атрибут элемента Boolean. Указывает, могут ли параметры конфигурации быть переопределены соответствующими параметрами из файлов Web.config, расположенных в дочерних каталогах. По умолчанию используется значение True. |
path |
Необязательный атрибут типа String. Определяет ресурс, к которому применяются параметры конфигурации. При использовании элемента location без атрибута path параметры конфигурации применяются к текущему каталогу и всем его дочерним каталогам. Если элемент location используется без атрибута path и для атрибут allowOverride установлено значение False, параметры конфигурации нельзя изменить файлами Web.config, которые находятся в дочерних каталогах. |
inheritInChildApplications |
Необязательный атрибут элемента Boolean. Задает, наследуются ли параметры конфигурации, связанные с определенным расположением (например, корневой каталог веб-узла), приложениями, находящимися подкаталогах. По умолчанию используется значение True. |
Дочерние элементы
Элемент location может включать в себя другие элементы либо в целях применения параметров конфигурации к конкретному ресурсу, либо для блокировки параметров конфигурации.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework. |
Заметки
Элемент location определяет ресурс, к которому применяются параметры дочерней конфигурации. Он также используется для блокировки параметров конфигурации, запрещая переопределять параметры файлами дочерней конфигурации.
Элемент location может включать в себя другие элементы либо в целях применения параметров конфигурации к конкретному ресурсу, либо для блокировки этих параметров. Дополнительные сведения см. в разделах Настройка отдельных файлов и подкаталогов и Блокировка параметров конфигурации.
Пример
В следующем примере показано, как разрешить анонимному пользователю доступ к странице Logon.aspx.
<configuration>
<location path="Logon.aspx">
<system.web>
<authorization>
<allow users="?"/>
</authorization>
</system.web>
</location>
</configuration>
В следующем примере показано, каким образом установить максимальный размер загружаемого файла равным 128 КБ только для заданной страницы.
<configuration>
<location path="UploadPage.aspx">
<system.web>
<httpRuntime maxRequestLength="128"/>
</system.web>
</location>
</configuration>
В следующем примере показано, каким образом запретить переопределение параметров конфигурации файлами Web.config, расположенными в дочерних каталогах.
<configuration>
<location allowOverride="false"/>
</configuration>
Сведения об элементе
Обработчик раздела конфигурации |
Не применяется. |
Член конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005 |
См. также
Задачи
Пошаговое руководство. Отключение параметров конфигурации ASP.NET
Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения
Ссылки
Элемент configuration (схема общих параметров)
Основные понятия
Общие сведения о конфигурационном ASP.NET
Настройка обеспечения безопасности ASP.NET
Блокировка параметров конфигурации
Настройка отдельных файлов и подкаталогов