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

Статья
11/16/2008

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

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

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

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

<expressionBuilders> 
   <add />
   <clear/>
   <remove />
</expressionBuilders>

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

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

Атрибуты

Нет.

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

Подтег	Описание
add	Необязательный элемент. Добавляет в коллекцию ссылку на построитель выражений.
clear	Необязательный элемент. Удаляет все ссылки на наследуемые построители выражений, за исключением тех ссылок, которые были добавлены с помощью текущего элемента add.
remove	Необязательный элемент. Удаляет из коллекции ссылку на наследуемый построитель выражений.

add

Необязательный элемент.

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

clear

Необязательный элемент.

Удаляет все ссылки на наследуемые построители выражений, за исключением тех ссылок, которые были добавлены с помощью текущего элемента add.

remove

Необязательный элемент.

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

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

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

Заметки

Элемент 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
Элемент конфигурации	ExpressionBuilders ExpressionBuilderCollection
Настраиваемые расположения	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

См. также

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

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

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

Атрибуты

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

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

Заметки

Конфигурация по умолчанию

Пример

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

См. также

Задачи

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

Ссылки

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

Дополнительные ресурсы