Adicionar elemento para expressionBuilders for compilation (ASP.NET Settings esquema)
Adiciona uma referência para um expressão construtor à coleção.
Esse elemento é novo no .NET Framework versão 2.0.
<configuration> Element
System.Web elemento (esquema configurações ASP.NET)
Elemento compilation (Esquema de configurações ASP.NET)
assemblies de elemento para compilation (ASP.NET Settings esquema)
Adicionar elemento para expressionBuilders for compilation (ASP.NET Settings esquema)
<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 |
Necessário String atributo. Especifica o prefixo para a expressão. Essa seqüência de caracteres é o lado esquerdo de uma expressão sistema autônomo 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 |
Necessário String atributo. Especifica o nome da classe de Construtor de Expressões que manipula esta expressão. Isso pode ser uma classe personalizada que deriva de 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 referente à seção de configuração do ASP.NET. |
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 caracteres de recurso a ser usada durante a compilação. As cadeias de recursos associe prefixos construtores de expressão. Esse elemento é novo no .NET Framework versão 2.0. |
Comentários
The add elemento adiciona uma referência a um construtor de expressões à coleção.
The expressionBuilders elemento define uma coleção de seqüências de caracteres de recurso a ser usada durante a compilação. As cadeias de recursos associe prefixos construtores de expressão.
Quando o analisador de página encontra uma expressão em uma página .aspx 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 de 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á configurado explicitamente na computador. arquivo de configuração ou na Web raiz. arquivo de configuração. No entanto, é a configuração padrão que é retornada pelo aplicativo. Itens são adicionados à expressionBuilders coleção na raiz arquivo Web.config.
<expressionBuilders>
<clear />
</expressionBuilders>
O seguinte padrão expressionBuilders elemento está configurado na Web raiz. arquivo de configuração.
<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 personalizado expressão construtor no arquivo Web.config. Um construtor de expressões personalizado deve implementar o 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>
Informações do elemento
Manipulador de seção de configuração |
|
Configuração de membro |
|
Locais configuráveis |
Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config |
Requisitos |
Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 O .NET estrutura versão 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005 |
Consulte também
Tarefas
Como: Configurar diretórios específicos usando configurações de local
Como: Bloquear ASP.NET Configuration Settings
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 configuração ASP.NET
Cenários de configuração ASP.NET
Referência
assemblies de elemento para compilation (ASP.NET Settings esquema)
Remover elemento para expressionBuilders for compilation (ASP.NET Settings esquema)
desmarcar o elemento de expressionBuilders for compilation (ASP.NET Settings esquema)
configuração elemento (Geral Settings esquema)
System.Web elemento (esquema configurações ASP.NET)
Elemento compilation (Esquema de configurações ASP.NET)
Outros recursos
Configurações gerais (ASP.NET)
Definições de configuração ASP.NET
Administrando ites da Web do ASP.NET