Вспомогательная функция тега среды в ASP.NET Core

  • Статья

Авторы: Питер Кельнер (Peter Kellner) и Хишам Бин Атея (Hisham Bin Ateya)

Вспомогательная функция тега среды условно отрисовывает заключенное в нее содержимое с учетом текущей среды размещения. Единственный атрибут вспомогательной функции тега среды, names, — это разделенный запятыми список имен сред. Если одно из указанных имен среды соответствует текущей среде, включенное содержимое подготавливается к просмотру.

Общие сведения о вспомогательных функциях тегов см. в разделе Вспомогательные функции тегов в ASP.NET Core.

Атрибуты вспомогательной функции тега среды

Имена

names принимает одно имя среды размещения или список разделенных запятыми имен сред размещения, которые запускают отрисовку включенного в функцию содержимого.

Значения среды сравниваются с текущим значением , возвращаемым IWebHostEnvironment.EnvironmentName. При сравнении регистр не учитывается.

В приведенном ниже примере используется вспомогательная функция тега среды. Содержимое подготавливается к просмотру в том случае, если среда размещения является промежуточной или рабочей:

<environment names="Staging,Production">
    <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong>
</environment>

Атрибуты include и exclude

include и exclude атрибуты управляют отображением закрытого содержимого на основе включенных или исключенных имен сред размещения.

include

Свойство include ведет себя так же для атрибута names. Среда, указанная в include значении атрибута, должна соответствовать среде размещения приложения (IWebHostEnvironment.EnvironmentName), чтобы отобразить содержимое тега <environment> .

<environment include="Staging,Production">
    <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong>
</environment>

исключение

В отличие от атрибута include, содержимое тега <environment> отрисовывается, когда среда размещения не соответствует среде, указанной в значении атрибута exclude.

<environment exclude="Development">
    <strong>IWebHostEnvironment.EnvironmentName is not Development</strong>
</environment>

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