Вспомогательная функция тега среды в 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>
Дополнительные ресурсы
ASP.NET Core