expressionBuilders elemento para compilação (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Define uma coleção de seqüências de recurso a ser usado durante a compilação. As seqüências de caracteres de recurso associar prefixos construtores de expressões.

Esse elemento é novo no .NET Framework versão 2.0.

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

Attributes and Elements

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Attributes

Nenhum.

Child Elements

Submarca

Descrição

add

Elemento opcional.

Adiciona uma referência a um construtor de expressões à coleção.

clear

Elemento opcional.

Remove todas as referências para construtores de expressão herdado, permitindo que somente as referências que são adicionadas pelo atual Adicionar elemento.

remove

Elemento opcional.

Remove uma referência a um construtor de expressões herdadas da coleção.

Parent Elements

Elemento

Descrição

configuration

Especifica o elemento de raiz em todos os arquivos de configuração que é usado pelo Common Language Runtime e os aplicativos .NET Framework.

system.web

Especifica o elemento raiz para o ASP.Seção de configuração de rede.

compilation

Configura todas as configurações de compilação que o ASP.NET usa para compilar aplicativos.

Remarks

O expressionBuilders elemento define uma coleção de seqüências de recurso a ser usado durante a compilação. As seqüências de caracteres de recurso associar prefixos construtores de expressões.

Quando o analisador de página encontra uma expressão em uma página. aspx com a seqüência de caracteres delimitada <%$ %>, o analisador cria um construtor de expressões para a expressão baseada no prefixo na seqüência de caracteres. O prefixo é a parte da seqüência de caracteres que está à esquerda dos dois pontos (:). Por exemplo, quando o analisador encontra a seqüência de caracteres <%$ ConnectionStrings:MessageDB %>, o analisador cria um ConnectionStringsExpressionBuilder objeto. Para obter mais informações, consulte ExpressionBuilder.

Configuração padrão

O seguinte padrão expressionBuilders elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, ele é a configuração padrão que é retornada pelo aplicativo. Itens são adicionados para o expressionBuilders coleção no arquivo Web. config raiz.

<expressionBuilders>
   <clear />
</expressionBuilders>

O seguinte padrão expressionBuilders elemento é configurado no arquivo Web. config raiz.

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

Exemplo

O exemplo de código a seguir mostra como registrar um construtor de expressões personalizado no arquivo Web. config. Um construtor de expressões personalizado deve implementar a ExpressionBuilder classe abstrata.

Para fazer referência a expressão em um arquivo. aspx, use a seguinte sintaxe:

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

Element Information

Manipulador da seção de configuração

CompilationSection

Membro de configuração

ExpressionBuilders

ExpressionBuilderCollection

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Directory–level virtuais ou físicas Web. config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0

A.NET Framework versão 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tasks

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

compilação Element (ASP.NET Settings Schema)

Adicionar elemento para expressionBuilders para compilação (ASP.NET Settings Schema)

Desmarque o elemento de expressionBuilders para compilação (ASP.NET Settings Schema)

remover o elemento expressionBuilders for compilation (ASP.NET Settings Schema)

buildProviders elemento para compilação (ASP.NET Settings Schema)

codeSubDirectories elemento for compilation (ASP.NET Settings Schema)

Elemento de compilers for compilation (ASP.NET Settings Schema)

conjuntos de elemento de compilação (ASP.NET Settings Schema)

configuração Element (General Settings Schema)

System. Web Element (ASP.NET Settings Schema)

System.Configuration

System.Web.Configuration

CompilationSection

ExpressionBuilders

ExpressionBuilderCollection

Concepts

ASP.NET Compilation Model

ASP.NET Web Page Syntax Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Other Resources

Configurações gerais (ASP.NET)

ASP.Definições de configuração de rede

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API