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

作者:Peter KellnerHisham Bin Ateya

环境标记帮助程序根据当前宿主环境,有条件地呈现其包含的内容。 环境标记帮助程序的单个属性 names 是以逗号分隔的环境名称列表。 任何提供的环境名称与当前环境匹配时,都会呈现包含的内容。

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

环境标记帮助程序属性

姓名

names 采用单个宿主环境名称或以逗号分隔的宿主环境名称列表,用于触发已包含内容的呈现。

将环境值与 IWebHostEnvironment.EnvironmentName 返回的当前值进行比较。 比较不区分大小写。

下面的示例使用图像标记帮助程序。 如果宿主环境是暂存或生产,则呈现内容:

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

include 和 exclude 属性

includeexclude 属性基于已包括或已排除的宿主环境名称,控制已包含内容的呈现。

include

include 属性表现出与 names 属性相似的行为。 include 属性值中列出的环境必须与应用的托管环境 (IWebHostEnvironment.EnvironmentName) 匹配才能呈现 <environment> 标记的内容。

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

排除

include 属性相反,当托管环境与 exclude 属性值中列出的环境不匹配时,将呈现 <environment> 标记的内容。

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

其他资源