Поделиться через

Элемент controls для pages (схема параметров ASP.NET)

  • Статья

Обновлен: Ноябрь 2007

Определяет коллекцию директив регистрации и пространства имен, где находятся префиксы тегов.

Этот элемент не использовался до .NET Framework версии 2.0.

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент pages (схема параметров ASP.NET)
      Элемент controls для pages (схема параметров ASP.NET)

 <controls>
     <add />
  </controls>

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Нет.

Дочерние элементы

Элемент

Описание

add

Необязательный элемент.

Добавляет префикс тега в коллекцию префиксов тегов, используемых во время процесса предварительной компиляции.

Родительские элементы

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

system.web

Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.

pages

Глобально определяет особые для страницы параметры конфигурации, такие как директивы ASP.NET для страниц и элементов управления, на которые распространяется действие данного файла конфигурации.

Заметки

Элемент controls определяет коллекцию директив регистрации и пространства имен, где находятся префиксы тегов. Этот элемент соответствует директиве @ Register на странице ASP.NET. Директива @ Register позволяет указать префикс тега для пользовательского элемента управления.

Префиксы тегов связывают пространство имен в ASP.NET со сборками и пространствами имен, которые необходимо включить для корректной работы пользовательских элементов управления и элементов управления COM. При настройке элемента controls можно использовать следующие сведения:

  • Для пользовательских элементов управления необходимо определить атрибуты tagPrefix, tagName и source дочернего элемента add.

  • Для настраиваемых элементов управления необходимо определить атрибуты tagPrefix, namespace и assembly дочернего элемента add. Указывать атрибут assembly не обязательно, если элемент управления находится в каталоге кода приложения.

Одно значение tagPrefix можно использовать для сопоставления с несколькими сборками или пространствами имен.

Конфигурация по умолчанию

В корневом файле Web.config задается следующий элемент controls по умолчанию.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

Пример

В следующем примере кода показывается декларативное задание значений для нескольких атрибутов элемента controls, к которым также можно обращаться программными средствами как к членам класса TagPrefixInfo.

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

Сведения об элементе

Обработчик раздела конфигурации

PagesSection

Элемент конфигурации

Controls

TagPrefixCollection

Настраиваемые расположения

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

Основные понятия

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Ссылки

Элемент pages (схема параметров ASP.NET)

Элемент add для элемента controls для элемента pages (схема параметров ASP.NET)

Элемент tagMapping для элемента pages (схема параметров ASP.NET)

Элемент namespaces для элемента pages (схема параметров ASP.NET)

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-узлов ASP.NET

Конфигурационный интерфейс API ASP.NET