compilation 的 buildProviders 的 add 元素（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 |
指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
system.web |
为 ASP.NET 配置节指定根元素。 |
compilation |
配置 ASP.NET 用于编译应用程序的所有编译设置。 |
buildProviders |
定义用于编译自定义资源文件的生成提供程序的集合。 |
备注
add 元素向 buildproviders 元素中包含的集合添加生成提供程序。
buildProviders 元素定义生成提供程序的集合，这些提供程序用于在编译期间编译特定文件类型的自定义资源文件并生成代码。
若要为 ASP.NET 应用程序中的某个文件类型定义自定义生成操作，必须从 BuildProvider 类派生类，在派生类中实现用于生成该文件类型的成员并为应用程序配置文件中相应的文件扩展名配置生成提供程序。 有关信息，请参见BuildProvider。
默认配置
下面的默认 buildProviders 元素是在根 Web.config 文件中配置的。
<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 Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
参考
compilation 的 buildProviders 元素（ASP.NET 设置架构）
compilation 的 buildProviders 的 clear 元素（ASP.NET 设置架构）
compilation 的 assemblies 的 remove 元素（ASP.NET 设置架构）