Compartir a través de


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

Actualización: noviembre 2007

Agrega a la colección una referencia a un generador 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)
        Elemento add aplicado a expressionBuilders para compilation (Esquema de configuración de ASP.NET)

<add
   expressionPrefix = "prefix" 
   type = "type" 
/>

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

expressionPrefix

Atributo String requerido.

Especifica el prefijo para la expresión. Esta cadena corresponde al lado izquierdo de una expresión cuando ésta aparece en una página .aspx, por ejemplo:

<asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" />

Ésta es la clave de colección.

El valor predeterminado es una cadena vacía ("").

type

Atributo String requerido.

Especifica el nombre de la clase de generador de expresiones que controla esta expresión. Puede tratarse de una clase personalizada derivada de la clase ExpressionBuilder.

El valor predeterminado es una cadena vacía ("").

Elementos secundarios

Ninguno.

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.

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.

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

Comentarios

El elemento add agrega a la colección una referencia a un generador de expresiones.

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 se encuentra a la izquierda de los dos puntos (:). Por ejemplo, cuando el analizador encuentra la cadena <%$ ConnectionStrings:MessageDB %>, 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 en el archivo Web.config raíz.

<expressionBuilders>
   <clear />
</expressionBuilders>

El siguiente elemento expressionBuilders predeterminado se configura en el archivo Web.config 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

Add

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

Modelo de código de las 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 assemblies para compilation (Esquema de configuración de ASP.NET)

Elemento remove 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 configuration (Esquema de configuración general)

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

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

System.Configuration

System.Web.Configuration

CompilationSection

Add

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