Элемент add для элемента buildProviders для элемента compilation (схема параметров ASP.NET)
Обновлен: Ноябрь 2007
Добавляет поставщика построения в коллекцию.
Этот элемент не использовался до .NET Framework версии 2.0.
Элемент <configuration>
Элемент system.web (схема параметров ASP.NET)
Элемент compilation (схема параметров ASP.NET)
Элемент buildProviders для элемента compilation (схема параметров ASP.NET)
Элемент add для элемента buildProviders для элемента compilation (схема параметров ASP.NET)
<add
extension="custom resource file extension"
type="build provider type, build provider assembly"
Code | Resources | All"
/>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
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
Основные понятия
Общие сведения о компиляции в ASP.NET
Модель кода веб-страниц ASP.NET
Иерархия и наследование файла конфигурации ASP.NET
Настройка обеспечения безопасности 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