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