ASP.NET Core 中的环境标记帮助程序

彼得·凯尔纳希沙姆·本·艾蒂亚

环境标记帮助程序根据当前 托管环境有条件地呈现其封闭内容。 环境标记辅助工具的唯一属性 names 是一个以逗号分隔的环境名称列表。 如果提供的任何环境名称与当前环境匹配,则呈现封闭的内容。

有关标记帮助程序概述,请参阅 ASP.NET Core 中的标记帮助程序。

环境标记助手属性

names

names 接受单个宿主环境名称或以逗号分隔的宿主环境名称列表,以触发封闭内容的呈现。

环境值与 IWebHostEnvironment.EnvironmentName 返回的当前值进行比较。 比较忽略大小写。

以下示例使用环境标记帮助程序。 如果宿主环境为过渡环境或生产环境,则呈现内容:

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

包括和排除属性

includeexclude 属性根据包含或排除的宿主环境名称来控制封闭内容的呈现。

包括

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>

其他资源