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

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

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

Элемент <configuration>
  Элемент system.web (схема параметров ASP.NET)
    Элемент compilation (схема параметров ASP.NET)
      Элемент buildProviders для элемента compilation (схема параметров ASP.NET)

<buildProviders> 
   <add />
   <clear/>
   <remove />
</buildProviders>

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

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

Атрибуты

Отсутствует.

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

Подтег

Описание

add

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

Добавляет поставщика построения в коллекцию.

clear

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

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

remove

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

Удаляет из коллекции ссылку на наследуемого поставщика построения.

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

Элемент

Описание

configuration

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

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

compilation

Настраивает все параметры, используемые ASP.NET для компиляции приложений.

Заметки

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

Для определения настраиваемых действий по построению для типа файла в приложении ASP.NET необходимо создать класс, производный от класса BuildProvider, реализовать члены в производном классе для создания типа файла и настроить поставщика построения для соответствующего расширения файла в файле конфигурации приложения. Сведения см. в разделе BuildProvider.

Настройки по умолчанию

Следующий элемент buildProviders по умолчанию не настроен явно в файле Machine.config или в корневом файле Web.config. Однако приложение возвращает конфигурацию, используемую по умолчанию. Элементы добавлены в коллекцию buildProviders в корневом файле Web.config.

<buildProviders>
   <clear />
</buildProviders>

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

<buildProviders>
   <add extension=".aspx" type="System.Web.Compilation.PageBuildProvider"/>
   <add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider"/>
   <add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider"/>
   <add extension=".asix" type="System.Web.Compilation.ImageGeneratorBuildProvider"/>
   <add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider"/>
   <add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider"/>
   <add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider"/>
   <add extension=".resx" type="System.Web.Compilation.ResXBuildProvider"/>
   <add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider"/>
   <add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider"/>
   <add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/>
   <add extension=".js" type="System.Web.Compilation.ForceCopyBuildProvider"/>
</buildProviders>

Пример

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

<configuration>
   <system.web>
      <compilation>
         <buildProviders>
            <buildProvider 
               extension=".mafx" 
               type="MyBuildProviderType, MyBuildProviderAssembly" />
         </buildProviders>
      </compilation>
   </system.web>
</configuration>

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

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

CompilationSection

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

BuildProviders

BuildProviderCollection

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

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

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

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

Сценарии конфигурации ASP.NET

Ссылки

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

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

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

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

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

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

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

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

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

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

System.Configuration

System.Web.Configuration

CompilationSection

BuildProviders

BuildProviderCollection

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

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

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

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

Файлы конфигурации ASP.NET

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