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

Статья
08/11/2011

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

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

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

Ссылки

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

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

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