expressionBuilders elemento para compilação (ASP.NET Configurações Schema)

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>

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Submarca	Descrição
add	Elemento opcional. Adiciona uma referência para o construtor de expressões à coleção.
clear	Elemento opcional. Remove todas as referências para construtores de expressão herdadas, permitindo que somente as referências são adicionadas pelo atual Adicionar elemento.
remove	Elemento opcional. Remove uma referência a um construtor de expressões herdadas da coleção.

Elementos pai

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.

Comentários

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 que é delimitada com a seqüência de caracteres <%$ %>, 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 é o elemento não explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, é a configuração padrão que é retornada pelo aplicativo. Itens são adicionados para o expressionBuilders a 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 o construtor de expressões personalizado no arquivo Web. config. O construtor de expressões personalizado deve implementar a ExpressionBuilder classe de 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>

Informações do elemento

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 Virtual ou física directory–level 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

Tarefas

Como: Configurar Diretórios Específicos Usando Configurações por Localização

Como: Bloquear definições de configuração ASP.NET

Referência

compilation Element (ASP.NET Settings Schema)

Adicionar elemento para expressionBuilders para compilação (ASP.NET Configurações Schema)

Desmarque elemento expressionBuilders para compilação (ASP.NET Configurações Schema)

remover o elemento expressionBuilders para compilação (ASP.NET Configurações Schema)

buildProviders elemento para compilação (ASP.NET Configurações Schema)

codeSubDirectories elemento para compilação (ASP.NET Configurações Schema)

Elemento de compiladores para compilação (ASP.NET Configurações Schema)

conjuntos de elemento de compilação (ASP.NET Configurações Schema)

configuração Element (Geral Configurações Schema)

system.web Element (ASP.NET Settings Schema)

System.Configuration

System.Web.Configuration

CompilationSection

ExpressionBuilders

ExpressionBuilderCollection

Conceitos

Visão geral da Compilação do ASP.NET

Visão geral da sintaxe de página da Web ASP.NET

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Administração de Sites do ASP.NET

Arquivos de configuração ASP.NET

API de Configuração do ASP.NET