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

Статья
08/11/2011

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

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

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

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

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

Атрибуты

Атрибут	Описание
expressionPrefix	Обязательный атрибут элемента String. Указывает префикс для выражения. Эта строка находится в левой части выражения, отображаемого на странице .aspx, например: <asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" /> Это ключ коллекции. Значение по умолчанию — пустая строка ("").
type	Обязательный атрибут String. Задает имя класса построителя выражений, обрабатывающего данное выражение. Это может быть настраиваемый класс, производный от класса ExpressionBuilder. Значение по умолчанию — пустая строка ("").

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

См. также

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

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

Ссылки

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

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

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