編譯的 expressionBuilders 項目 (ASP.NET 設定結構描述)
定義編譯期間所要使用的資源字串集合。 資源字串會使前置詞與運算式產生器產生關聯。
這個項目是 .NET Framework 2.0 版中新增的項目。
<expressionBuilders>
<add />
<clear/>
<remove />
</expressionBuilders>
屬性和項目
下列各節將說明屬性、子項目和父項目。
屬性
無。
子項目
子標記 |
說明 |
|---|---|
add |
選擇性項目。 將運算式產生器的參考加入集合。 |
clear |
選擇性項目。 移除繼承運算式產生器的所有參考，只保留目前的 add 項目所加入的參考。 |
remove |
選擇性項目。 從集合中移除繼承運算式產生器 (Builder) 的參考。 |
父項目
項目 |
說明 |
|---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。 |
system.web |
指定 ASP.NET 組態區段的根項目。 |
compilation |
設定 ASP.NET 用來編譯應用程式的所有編譯設定。 |
備註
expressionBuilders 項目會定義編譯期間所要使用的資源字串集合。 資源字串會使前置詞與運算式產生器產生關聯。
當頁面剖析器 (Parser) 在以 <%$ %> 字串分隔的.aspx 頁面中發現運算式時，剖析器便會依據字串中的前置詞為該運算式建立運算式產生器。 前置詞就是字串中分號 (:) 左邊的部分。 例如，在發現 <%$ ConnectionStrings:MessageDB %> 字串時，剖析器就會建立 ConnectionStringsExpressionBuilder 物件。 如需詳細資訊，請參閱 ExpressionBuilder。
預設組態
下列預設 expressionBuilders 項目不會明確地設定在 Machine.config 檔案或根 Web.config 檔案中。 然而，應用程式傳回的是預設組態。 項目會加入根 Web.config 檔的 expressionBuilders 集合。
<expressionBuilders>
<clear />
</expressionBuilders>
下列的預設 expressionBuilders 項目是在根 Web.config 檔中設定。
<expressionBuilders>
<add expressionPrefix="Resources" type="System.Web.Compilation.ResourceExpressionBuilder" />
<add expressionPrefix="ConnectionStrings" type="System.Web.Compilation.ConnectionStringsExpressionBuilder" />
<add expressionPrefix="AppSettings" type="System.Web.Compilation.AppSettingsExpressionBuilder" />
</expressionBuilders>
範例
下列程式碼範例示範如何在 Web.config 檔中註冊自訂運算式產生器。 自訂運算式產生器必須實作 ExpressionBuilder 抽象類別。
若要參考 .aspx 檔中的運算式，請使用下列語法：
<asp:Label ID="Label1" runat="server"
Text="<%$ MyCustomExpression:Hello, world! %>" />
<configuration>
<system.web>
<compilation>
<expressionBuilders>
<add expressionPrefix="MyCustomExpression"
type="MyCustomExpressionBuilder"/>
</expressionBuilders>
</compilation>
</system.web>
</configuration>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
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 |
請參閱
工作
參考
compilation 項目 (ASP.NET 設定結構描述)
編譯之 expressionBuilders 的 add 項目 (ASP.NET 設定結構描述)
編譯之 expressionBuilders 的 clear 項目 (ASP.NET 設定結構描述)
編譯之 expressionBuilders 的 remove 項目 (ASP.NET 設定結構描述)
編譯的 buildProviders 項目 (ASP.NET 設定結構描述)
編譯的 codeSubDirectories 項目 (ASP.NET 設定結構描述)
編譯的 compilers 項目 (ASP.NET 設定結構描述)
編譯的 assemblies 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)