Поделиться через

Элемент add для элемента expressionBuilders для элемента compilation (схема параметров ASP.NET)

  • Статья

Обновлен: Ноябрь 2007

Добавляет в коллекцию ссылку на построитель выражений.

Этот элемент не использовался до .NET Framework версии 2.0.

Элемент <configuration>
  Элемент system.web (схема параметров ASP.NET)
    Элемент compilation (схема параметров ASP.NET)
      Элемент assemblies для элемента compilation (схема параметров ASP.NET)
        Элемент add для элемента expressionBuilders для элемента compilation (схема параметров ASP.NET)

<add    expressionPrefix = "prefix"     type = "type"  />

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.

Атрибуты

Атрибут

Описание

expressionPrefix

Обязательный атрибут String.

Указывает префикс для выражения. Эта строка находится в левой части выражения, отображаемого на странице .aspx, например:

<asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" />

Это ключ коллекции.

Значение по умолчанию — пустая строка ("").

type

Обязательный атрибут String.

Задает имя класса построителя выражений, обрабатывающего данное выражение. Это может быть настраиваемый класс, производный от класса ExpressionBuilder.

Значение по умолчанию — пустая строка ("").

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент

Описание

configuration

Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework.

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

compilation

Настраивает все параметры, используемые ASP.NET для компиляции приложений.

expressionBuilders

Определяет коллекцию строк ресурсов, подлежащих использованию при компиляции. Строки ресурсов связывают префиксы с построителями выражений.

Этот элемент не использовался до .NET Framework версии 2.0.

Заметки

Элемент add добавляет в коллекцию ссылку на построителя выражений.

Элемент expressionBuilders определяет коллекцию строк ресурсов, подлежащих использованию при компиляции. Строки ресурсов связывают префиксы с построителями выражений.

Когда анализатор страниц обнаруживает на странице .aspx выражение, разделенное строкой <%$ %>, он создает построитель выражений, основанный на префиксе строки. Префикс является частью строки и находится слева от двоеточия (:). Например, когда анализатор встречает строку <%$ ConnectionStrings:MessageDB %>, он создает объект ConnectionStringsExpressionBuilder. Дополнительные сведения см. в разделе ExpressionBuilder.

Настройки по умолчанию

Следующий используемый по умолчанию элемент expressionBuilders не настраивается явно ни в файле Machine.config, ни в корневом файле Web.config. Однако приложение возвращает конфигурацию, используемую по умолчанию. Элементы добавляются в коллекцию expressionBuilders в корневом файле Web.config.

<expressionBuilders>
   <clear />
</expressionBuilders>

В корневом файле Web.config задан по умолчанию следующий элемент expressionBuilders.

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

Пример

В следующем примере кода показана регистрация настраиваемого построителя выражений в файле Web.config. Настраиваемый построитель выражений должен реализовать абстрактный класс ExpressionBuilder.

Для ссылки выражения в файле .aspx используется следующий синтаксис.

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

Сведения об элементе

Обработчик раздела конфигурации

CompilationSection

Элемент конфигурации

Add

Настраиваемые расположения.

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Основные понятия

Общие сведения о компиляции в ASP.NET

Модель кода веб-страниц ASP.NET

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Ссылки

Элемент assemblies для элемента compilation (схема параметров ASP.NET)

Элемент remove для элемента expressionBuilders для элемента compilation (схема параметров ASP.NET)

Элемент clear для элемента expressionBuilders для элемента compilation (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент system.web (схема параметров ASP.NET)

Элемент compilation (схема параметров ASP.NET)

System.Configuration

System.Web.Configuration

CompilationSection

Add

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-узлов ASP.NET

Файлы конфигурации ASP.NET

Конфигурационный интерфейс API ASP.NET