Элемент add для элемента buildProviders для элемента compilation (схема параметров ASP.NET)
Добавляет поставщика построения в коллекцию.
Этот элемент не использовался до .NET Framework версии 2.0.
<add
extension="custom resource file extension"
type="build provider type, build provider assembly" />
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
extension |
Обязательный атрибут элемента String. Определяет расширение пользовательского файла ресурсов. Этот атрибут является ключом коллекции. Значение по умолчанию — пустая строка (""). |
type |
Обязательный атрибут элемента String. Определяет тип и сборку, которые необходимо использовать для компиляции файлов, указанных с помощью атрибута extension . Значение по умолчанию — пустая строка (""). |
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework. |
system.web |
Задает корневой элемент для раздела конфигурации ASP.NET. |
compilation |
Настраивает все параметры, используемые ASP.NET для компиляции приложений. |
buildProviders |
Определяет коллекцию поставщиков построений, которые используются для компиляции пользовательских файлов ресурсов. |
Заметки
Элемент add добавляет поставщика построения в коллекцию элемента buildproviders.
Элемент buildProviders определяет коллекцию поставщиков построений, используемых для компиляции пользовательских файлов ресурсов определенного типа файла и для создания кода во время компиляции.
Для определения настраиваемых действий по построению для типа файла в приложении ASP.NET необходимо создать класс, производный от класса BuildProvider, реализовать члены в производном классе для создания типа файла и настроить поставщика построения для соответствующего расширения файла в файле конфигурации приложения. Дополнительные сведения см. в разделе BuildProvider.
Параметры по умолчанию
В корневом файле 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>
<add
extension=".mafx"
type="MyBuildProviderType, MyBuildProviderAssembly"/>
</buildProviders>
</compilation>
</system.web>
</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
Ссылки
Элемент buildProviders для элемента compilation (схема параметров ASP.NET)
Элемент clear для элемента buildProviders для элемента compilation (схема параметров ASP.NET)
Элемент remove для элемента assemblies для элемента compilation (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Элемент system.web (схема параметров ASP.NET)
Элемент compilation (схема параметров ASP.NET)
Основные понятия
Общие сведения о компиляции в ASP.NET
Модель кода веб-страниц ASP.NET
Иерархия и наследование файла конфигурации ASP.NET
Настройка обеспечения безопасности ASP.NET
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET