compilation 的 expressionBuilders 的 add 元素(ASP.NET 设置架构)

向集合中添加对表达式生成器的引用。

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

<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>

元素信息

配置节处理程序

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

请参见

任务

如何:使用位置设置配置特定目录

如何:锁定 ASP.NET 配置设置

参考

compilation 的 assemblies 元素(ASP.NET 设置架构)

compilation 的 expressionBuilders 的 remove 元素(ASP.NET 设置架构)

compilation 的 expressionBuilders 的 clear 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

system.web 元素(ASP.NET 设置架构)

compilation 元素(ASP.NET 设置架构)

System.Configuration

System.Web.Configuration

CompilationSection

Add

概念

ASP.NET 编译概述

ASP.NET 网页代码模型

ASP.NET 配置文件层次结构和继承

保证 ASP.NET 配置的安全

ASP.NET 配置方案

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

ASP.NET 网站管理

ASP.NET 配置文件

ASP.NET 配置 API