Compartir a través de


Elemento expressionBuilders para compilation (Esquema de configuración de ASP.NET)

Actualización: noviembre 2007

Define una colección de cadenas de recursos que se van a usar durante la compilación. Las cadenas de recursos asocian prefijos a los generadores de expresiones.

Se trata de un elemento nuevo en .NET Framework versión 2.0.

Elemento <configuration>
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento compilation (Esquema de configuración de ASP.NET)
      Elemento assemblies para compilation (Esquema de configuración de ASP.NET)

<expressionBuilders> 
   <add />
   <clear/>
   <remove />
</expressionBuilders>

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Subetiqueta

Descripción

add

Elemento opcional.

Agrega una referencia a un generador de expresiones a la colección.

clear

Elemento opcional.

Quita todas las referencias a generadores de expresiones heredados y permite sólo aquellas referencias agregadas por el elemento add actual.

remove

Elemento opcional.

Quita una referencia a un generador de expresiones heredado de la colección.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz de cada archivo de configuración usado por Common Language Runtime y las aplicaciones .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

compilation

Configura todas las opciones de compilación que utiliza ASP.NET para compilar aplicaciones.

Comentarios

El elemento expressionBuilders define una colección de cadenas de recursos que se van a usar durante la compilación. Las cadenas de recursos asocian prefijos a los generadores de expresiones.

Cuando el analizador de páginas encuentra una expresión en una página .aspx delimitada con la cadena <%$ %>, el analizador crea un generador de expresiones para la expresión basándose en el prefijo de la cadena. El prefijo es la parte de la cadena que está a la izquierda de los dos puntos (:). Por ejemplo, cuando el analizador encuentra la cadena <%$ ConnectionStrings:MessageDB %>, el analizador crea un objeto ConnectionStringsExpressionBuilder. Para obtener más información, vea ExpressionBuilder.

Configuración predeterminada

El siguiente elemento predeterminado expressionBuilders no está configurado explícitamente en el archivo Machine.config ni en el archivo Web.config de la raíz. Sin embargo, es la configuración predeterminada que devuelve la aplicación. Los elementos se agregan a la colección expressionBuilders del archivo Web.config de la raíz.

<expressionBuilders>
   <clear />
</expressionBuilders>

El elemento expressionBuilders predeterminado se configura en el archivo Web.config de la raíz.

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

Ejemplo

En el siguiente ejemplo de código se muestra cómo registrar un generador de expresiones personalizado en el archivo Web.config. Un generador de expresiones personalizado debe implementar la clase abstracta ExpressionBuilder.

Para hacer referencia a la expresión de un archivo .aspx, utilice la sintaxis siguiente:

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

Información de elemento

Controlador de la sección de configuración

CompilationSection

Miembro de configuración

ExpressionBuilders

ExpressionBuilderCollection

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos   

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 o 6.0

.NET Framework versión 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Configurar directorios concretos mediante la configuración de la ubicación

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la compilación de ASP.NET

Información general sobre sintaxis de páginas web ASP.NET

Jerarquía de archivos y herencia de la configuración de ASP.NET

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

Elemento compilation (Esquema de configuración de ASP.NET)

Elemento add aplicado a expressionBuilders para compilation (Esquema de configuración de ASP.NET)

Elemento clear aplicado a expressionBuilders para compilation (Esquema de configuración de ASP.NET)

Elemento remove aplicado a expressionBuilders para compilation (Esquema de configuración de ASP.NET)

Elemento buildProviders para compilation (Esquema de configuración de ASP.NET)

Elemento codeSubDirectories para compilation (Esquema de configuración de ASP.NET)

Elemento compilers para compilation (Esquema de configuración de ASP.NET)

Elemento assemblies para compilation (Esquema de configuración de ASP.NET)

Elemento configuration (Esquema de configuración general)

Elemento system.web (Esquema de configuración de ASP.NET)

System.Configuration

System.Web.Configuration

CompilationSection

ExpressionBuilders

ExpressionBuilderCollection

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administrar sitios web ASP.NET

Archivos de configuración de ASP.NET

API de configuración de ASP.NET