Version: 1.0 | 1.1 |


in namespace DotVVM.Framework.Controls


Name Type Description Notes Default Value


Name Type Description

Usage & Scenarios

Allows to render content when an application is running on a specific environment (eg. Development, Production). We use an IEnvironmentNameProvider service to get the name of the current environment. The default implementation behaves differently on OWIN and on ASP.NET Core.

  • On ASP.NET Core: We simply use the IHostingEnvironment.EnvironmentName property to get the name.
  • On OWIN: We use a value stored in the environment dictionary under the host.AppMode key. If you host your application on System.Web the value is automatically set to Development when debugging is enabled in Web.config.

In both cases the default environment name is Production. You may override this behavior by implementing your own IEnvironmentNameProvider.

HTML Rendered by the Control

The control renders the contents of the IsEnvironmentTemplate or IsNotEnvironmentTemplate property. Optionally you can enable wrapper tag rendering using the RenderWrapperTag property. The tag name can be changed using the WrapperTagName property.

    <!-- Contents of the IsEnvironmentTemplate or IsNotEnvironmentTemplate -->

Sample 1: EnvironmentView

The Environments property contains a comma-separated list of environment names.

The IsEnvironmentTemplate defines the content rendered when the application is running on one of the specified Environments.

The IsNotEnvironmentTemplate defines the content rendered on other environments.

<dot:EnvironmentView Environments="Production,Development">
    Production or Development environment.

<dot:EnvironmentView Environments="Staging">
        Staging environment.
        Other environment.


Help & Contribute

The documentation is maintained on GitHub.
We'll be happy if you edit the page and create a pull request.

Send message