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
属性相反,当托管环境与 exclude
属性值中列出的环境不匹配时,将呈现 <environment>
标记的内容。
<environment exclude="Development">
<strong>IWebHostEnvironment.EnvironmentName is not Development</strong>
</environment>