Adicionar elemento para expressionBuilders 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.]
Adiciona uma referência a um construtor de expressões à coleção.
Esse elemento é novo no .NET Framework versão 2.0.
<add
expressionPrefix = "prefix"
type = "type"
/>
Attributes and Elements
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Attributes
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 lida com essa expressão. Isso pode ser uma classe personalizada que deriva do ExpressionBuilder classe. The default is an empty string (""). |
Child Elements
Nenhum.
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. |
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. |
Remarks
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 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 %>, ele 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 |
|
Membro de configuração |
|
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
conjuntos de elemento de compilação (ASP.NET Settings Schema)
remover o elemento expressionBuilders for compilation (ASP.NET Settings Schema)
Desmarque o elemento de expressionBuilders para compilação (ASP.NET Settings Schema)
configuração Element (General Settings Schema)
System. Web Element (ASP.NET Settings Schema)
compilação Element (ASP.NET Settings Schema)
Concepts
ASP.NET Configuration File Hierarchy
Other Resources
Configurações gerais (ASP.NET)
ASP.Definições de configuração de rede