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 |
|
Miembro de configuración |
|
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)
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Administrar sitios web ASP.NET