compilation 的 expressionBuilders 的 add 元素（ASP.NET 设置架构）
更新：2007 年 11 月
向集合中添加对表达式生成器的引用。
此元素是 .NET Framework 2.0 版中的新元素。
<configuration> 元素
system.web 元素（ASP.NET 设置架构）
compilation 元素（ASP.NET 设置架构）
compilation 的 assemblies 元素（ASP.NET 设置架构）
compilation 的 expressionBuilders 的 add 元素（ASP.NET 设置架构）
<add
expressionPrefix = "prefix"
type = "type"
/>
属性和元素
以下几节描述了属性、子元素和父元素。
属性
属性 |
说明 |
|---|---|
expressionPrefix |
必选的 String 属性。 指定表达式的前缀。此字符串是表达式的左侧，因为它出现在 .aspx 页中，例如： <asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" /> 这是集合键。 默认值为空字符串 ("")。 |
type |
必选的 String 属性。 指定用来处理此表达式的表达式生成器类的名称。这可以是从 ExpressionBuilder 类派生的自定义类。 默认值为空字符串 ("")。 |
子元素
无。
父元素
元素 |
说明 |
|---|---|
configuration |
指定公共语言运行库和 .NET Framework 应用程序使用的每个配置文件中的根元素。 |
system.web |
为 ASP.NET 配置节指定根元素。 |
compilation |
配置 ASP.NET 用于编译应用程序的所有编译设置。 |
expressionBuilders |
定义一个要在编译期间使用的资源字符串的集合。资源字符串将前缀与表达式生成器关联起来。 此元素是 .NET Framework 2.0 版中的新元素。 |
备注
add 元素向集合中添加对表达式生成器的引用。
expressionBuilders 元素定义一个要在编译期间使用的资源字符串的集合。资源字符串将前缀与表达式生成器关联起来。
当页分析器在 .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 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
概念
参考
compilation 的 assemblies 元素（ASP.NET 设置架构）
compilation 的 expressionBuilders 的 remove 元素（ASP.NET 设置架构）
compilation 的 expressionBuilders 的 clear 元素（ASP.NET 设置架构）