Adicionar elemento para expressionBuilders para compilação (ASP.NET Configurações Schema)
Adiciona uma referência para o construtor de expressões à coleção.
Esse elemento é novo no .NET Framework versão 2.0.
<add
expressionPrefix = "prefix"
type = "type"
/>
Atributos e elementos
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Atributos
Atributo |
Descrição |
|---|---|
expressionPrefix |
Obrigatório String atributo. Especifica o prefixo para a expressão. Essa seqüência de caracteres é o lado esquerdo de uma expressão, como ele aparece em uma página. aspx, por exemplo: <asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" /> Esta é a chave da coleção. The default is an empty string (""). |
type |
Obrigatório String atributo. Especifica o nome da classe de construtor de expressão que manipula essa expressão. Isso pode ser uma classe personalizada que deriva do ExpressionBuilder classe. The default is an empty string (""). |
Elementos filho
Nenhum.
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. |
expressionBuilders |
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. |
Comentários
O add elemento adiciona uma referência a um construtor de expressões à coleção.
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 %>, ele 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 |
|
Membro de configuração |
|
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 |
De da (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
conjuntos de elemento de compilação (ASP.NET Configurações Schema)
remover o elemento expressionBuilders para compilação (ASP.NET Configurações Schema)
Desmarque elemento expressionBuilders para compilação (ASP.NET Configurações Schema)
configuração Element (Geral Configurações Schema)
system.web Element (ASP.NET Settings Schema)
compilation Element (ASP.NET Settings Schema)
Conceitos
Visão geral da Compilação do ASP.NET
Modelo de código de página Web do 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