ASP.NET Core 中的环境标记帮助程序Environment Tag Helper in ASP.NET Core

本文内容

作者:Peter KellnerHisham Bin Ateya

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

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

环境标记帮助程序属性Environment Tag Helper Attributes

姓名names

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

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

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

  1. <environment names="Staging,Production">
  2. <strong>HostingEnvironment.EnvironmentName is Staging or Production</strong>
  3. </environment>

include 和 exclude 属性include and exclude attributes

include & exclude 特性控件基于包含或已排除的宿主环境名称呈现包含的内容。

includeinclude

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

  1. <environment include="Staging,Production">
  2. <strong>HostingEnvironment.EnvironmentName is Staging or Production</strong>
  3. </environment>

excludeexclude

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

  1. <environment exclude="Development">
  2. <strong>HostingEnvironment.EnvironmentName is not Development</strong>
  3. </environment>

其他资源Additional resources