Environment Tag Helper in ASP.NET Core
By Peter Kellner and Hisham Bin Ateya
The Environment Tag Helper conditionally renders its enclosed content based on the current hosting environment. The Environment Tag Helper's single attribute,
names, is a comma-separated list of environment names. If any of the provided environment names match the current environment, the enclosed content is rendered.
For an overview of Tag Helpers, see Tag Helpers in ASP.NET Core.
Environment Tag Helper Attributes
names accepts a single hosting environment name or a comma-separated list of hosting environment names that trigger the rendering of the enclosed content.
Environment values are compared to the current value returned by IWebHostEnvironment.EnvironmentName. The comparison ignores case.
The following example uses an Environment Tag Helper. The content is rendered if the hosting environment is Staging or Production:
<environment names="Staging,Production"> <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong> </environment>
include and exclude attributes
exclude attributes control rendering the enclosed content based on the included or excluded hosting environment names.
include property exhibits similar behavior to the
names attribute. An environment listed in the
include attribute value must match the app's hosting environment (IWebHostEnvironment.EnvironmentName) to render the content of the
<environment include="Staging,Production"> <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong> </environment>
In contrast to the
include attribute, the content of the
<environment> tag is rendered when the hosting environment doesn't match an environment listed in the
exclude attribute value.
<environment exclude="Development"> <strong>IWebHostEnvironment.EnvironmentName is not Development</strong> </environment>
Submit and view feedback for