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

Статья
08/11/2011

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

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

<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 можно использовать для сопоставления с несколькими сборками или пространствами имен.

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

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

<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

См. также

Share via

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы