compilation 的 buildProviders 的 add 元素（ASP.NET 设置架构）

项目
09/04/2008

更新：2007 年 11 月

向集合添加生成提供程序。

此元素是 .NET Framework 2.0 版中的新元素。

<configuration> 元素
   system.web 元素（ASP.NET 设置架构）
    compilation 元素（ASP.NET 设置架构）
      compilation 的 buildProviders 元素（ASP.NET 设置架构）
        compilation 的 buildProviders 的 add 元素（ASP.NET 设置架构）

<add 
   extension="custom resource file extension"
   type="build provider type, build provider assembly"
   Code | Resources | All"
/>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性	说明
extension	必选的 String 属性。定义自定义资源文件扩展名。此属性是集合键。默认值为空字符串 ("")。
type	必选的 String 属性。定义用于编译 extension 属性指定的文件的类型和程序集。默认值为空字符串 ("")。

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>

元素信息

配置节处理程序	CompilationSection
配置成员	Add
可配置的位置	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 的 add 元素（ASP.NET 设置架构）

属性和元素

属性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

概念

参考

其他资源

其他资源