共用方式為


編譯的 buildProviders 項目 (ASP.NET 設定結構描述)

定義用來編譯自訂資源檔的組建提供者集合。

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

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

無。

子項目

子標記

說明

add

選擇性項目。

將組建提供者加入集合。

clear

選擇性項目。

移除繼承之組建提供者的所有參考,只允許由目前的 add 項目所加入的組建提供者。

remove

選擇性項目。

移除集合中繼承組建提供者的參考。

父項目

項目

說明

configuration

指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。

system.web

指定 ASP.NET 組態區段的根項目。

compilation

設定 ASP.NET 用來編譯應用程式的所有編譯設定。

備註

buildProviders 項目會定義組建提供者的集合,用來在編譯期間編譯特定檔案類型的自訂資源檔及產生程式碼。

若要在 ASP.NET 應用程式內定義檔案類型的自訂建置動作,您必須從 BuildProvider 類別衍生類別,在該衍生類別內實作用於建置檔案類型的成員,並在應用程式組態檔內設定對應副檔名的組建提供者。 如需詳細資訊,請參閱 BuildProvider

預設組態

下列預設 buildProviders 項目不會明確地設定在 Machine.config 檔案或根 Web.config 檔案中。 然而,應用程式傳回的是預設組態。 項目會加入根 Web.config 檔內的 buildProviders 集合中。

<buildProviders>
   <clear />
</buildProviders>

下列的預設 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>
            <buildProvider 
               extension=".mafx" 
               type="MyBuildProviderType, MyBuildProviderAssembly" />
         </buildProviders>
      </compilation>
   </system.web>
</configuration>

項目資訊

組態區段處理常式

CompilationSection

組態成員

BuildProviders

BuildProviderCollection

可設定的位置

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

虛擬或實體目錄層級的 Web.config

需求

Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0

.NET Framework 2.0

Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

工作

HOW TO:使用位置設定來設定特定的目錄

HOW TO:鎖定 ASP.NET 組態設定

參考

compilation 項目 (ASP.NET 設定結構描述)

編譯之 buildProviders 的 add 項目 (ASP.NET 設定結構描述)

編譯之 buildProviders 的 clear 項目 (ASP.NET 設定結構描述)

編譯之 buildProviders 的 remove 項目 (ASP.NET 設定結構描述)

編譯的 assemblies 項目 (ASP.NET 設定結構描述)

編譯的 codeSubDirectories 項目 (ASP.NET 設定結構描述)

編譯的 compilers 項目 (ASP.NET 設定結構描述)

編譯的 expressionBuilders 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

system.web 項目 (ASP.NET 設定結構描述)

System.Configuration

System.Web.Configuration

CompilationSection

BuildProviders

BuildProviderCollection

概念

ASP.NET 編譯概觀

ASP.NET Web 網頁語法概觀

ASP.NET 組態檔階層架構和繼承

保護 ASP.NET 組態

ASP.NET 組態案例

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

ASP.NET 網站管理

ASP.NET 組態檔

ASP.NET 組態 API