Elemento expressionBuilders para compilation (Esquema de configuración de ASP.NET)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
Define una colección de cadenas de recursos que se van a usar durante la compilación. Las cadenas de recursos asocian los prefijos con generadores de expresiones.
Se trata de un elemento nuevo en .NET Framework, versión 2.0.
<expressionBuilders>
<add />
<clear/>
<remove />
</expressionBuilders>
Atributos y elementos
En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Ninguno.
Elementos secundarios
Subetiqueta |
Descripción |
|---|---|
add |
Elemento opcional. Agrega a la colección una referencia a un generador de expresiones. |
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 que utilizan las aplicaciones basadas en Common Language Runtime y .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 los prefijos con 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 situada a la izquierda del signo de 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 en el archivo Web.config 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
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
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)
Conceptos
ASP.NET Web Page Syntax Overview
ASP.NET Configuration File Hierarchy
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET